FreeRTOS Windows模拟器CMake项目64位返回值接收失败问题

问题现象 #

• VS Code中用CMake构建FreeRTOS Windows模拟器项目：
  • 执行cmake -S . -B build或cmake -S . -A x64 -B build生成x64项目时，调用buf = (char *)pvPortMalloc(100 * 30);后，buf仅保留返回地址的低32位（如0x0000000053cb6a98），高32位被置0，调试器显示RAX寄存器的值也为该截断后的地址，而pvPortMalloc的实际符号地址为Console.exe!0x00007ff753cb6a98。
  • 用cmake -S . -A Win32 -B build生成32位项目时，地址截断问题完全消失。

核心原因 #

1. 隐式函数声明导致类型不匹配：若代码未包含FreeRTOS.h等必要头文件，编译器会将pvPortMalloc隐式声明为返回int类型。x64环境下int为32位宽度，会直接截断64位指针返回值，造成高32位丢失。
2. FreeRTOS端口的x64适配问题：部分旧版FreeRTOS Windows模拟器的内存分配实现未适配x64架构，pvPortMalloc内部仅生成32位指针，无法输出完整的64位内存地址。

解决方法 #

1. 强制引入正确的函数声明 #

在调用pvPortMalloc的源文件开头，必须包含FreeRTOS核心头文件，避免隐式声明：

#include "FreeRTOS.h"
#include "task.h"

FreeRTOS.h中已明确声明pvPortMalloc为void *pvPortMalloc( size_t xWantedSize );，编译器会按64位指针类型处理返回值，避免截断。

2. 升级或适配FreeRTOS x64端口 #

• 若使用旧版FreeRTOS，直接升级到最新稳定版，新版本已完善Windows x64平台的内存分配实现。
• 手动检查portable/Win32/目录下的内存分配源码（如heap_4.c），确保内存堆的基地址和指针运算采用64位类型：

  // 示例：确保堆指针为64位兼容类型
  static uint64_t ulNextFreeByte = (uint64_t) ucHeap;
  

3. 修正CMake编译配置 #

在CMakeLists.txt中明确指定x64编译选项，避免混合32/64位编译：

cmake_minimum_required(VERSION 3.15)
project(FreeRTOS_Win_Sim)

set(CMAKE_C_STANDARD 99)

# 针对x64平台添加专属编译宏
if(CMAKE_GENERATOR_PLATFORM STREQUAL "x64")
    add_compile_definitions(configUSE_64_BIT_TICKS=1)
    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -m64")
endif()

# 引入FreeRTOS源码
add_subdirectory(FreeRTOS)

add_executable(Console main.c)
target_link_libraries(Console PRIVATE FreeRTOS)

验证流程 #

1. 删除旧build目录：rd /s /q build（Windows）或rm -rf build（Linux/WSL）
2. 重新生成x64项目：cmake -S . -A x64 -B build
3. 编译调试，检查buf变量是否能获取完整的64位指针地址。

内容的提问来源于stack exchange，提问作者Stephen