前言
初学 FreeRTOS 创建任务时，很容易遇到一段代码：部分任务创建时第六个参数传入任务句柄变量地址，另一部分直接填写NULL，二者写法都能正常创建任务，但底层用途完全不同。
先一句话说清区别：第六个参数pxCreatedTask是"任务句柄的输出指针"——传&xHandleTask1这类变量地址，内核会把创建好的任务句柄存进这个变量，之后你就能在别的任务里动态挂起 / 恢复 / 删除它；传NULL则是不保存句柄，任务创建后外部再也无法操控它，适合那些上电就常驻、无需外部干预的后台任务。任务本身能不能跑、怎么调度，两种写法完全一样，区别只在"外部手里有没有这把控制钥匙"。
本文结合标准源码示例，拆解xTaskCreate第六个输出参数的作用、使用场景与取舍逻辑。
目录
- 一、xTaskCreate 完整函数原型
- 二、源码示例对照解析
- 1. Task1 传入 &xHandleTask1 的逻辑
- 2. Task2 传入 NULL 的逻辑
- 三、补充关键知识点
- 3.1 两种传参方式不影响任务基础运行
- 3.2 任务内部获取自身句柄
- 3.3 任务创建失败时的变量状态
- 四、工程选型规范（项目实操标准）
- 五、总结
一、xTaskCreate 完整函数原型
先明确标准 API 定义，第六个参数pxCreatedTask是核心讲解对象：
BaseType_txTaskCreate(TaskFunction_t pvTaskCode,// 任务函数入口constchar*constpcName,// 任务名称字符串uint16_tusStackDepth,// 任务栈深度void*pvParameters,// 传入任务的参数UBaseType_t uxPriority,// 任务优先级TaskHandle_t*pxCreatedTask// 任务句柄输出指针（本文重点）);pxCreatedTask属于输出型指针参数，用于接收内核分配的任务唯一标识 —— 任务句柄TaskHandle_t。该参数为可选参数，支持传入有效变量地址或NULL。
二、源码示例对照解析
基于截图中的完整 main 函数片段拆分对比：
// 1. 定义任务句柄变量TaskHandle_t xHandleTask1;// 省略硬件初始化、打印逻辑...// Task1：传入句柄变量地址 &xHandleTask1xTaskCreate(Task1Function,"Task1",100,NULL,1,&xHandleTask1);// Task2：直接传入 NULLxTaskCreate(Task2Function,"Task2",100,NULL,1,NULL);vTaskStartScheduler();1. Task1 传入 &xHandleTask1 的逻辑
任务创建成功后，FreeRTOS 内核会将当前任务的句柄存入
xHandleTask1变量；句柄是任务全局唯一标识，拿到句柄后，可在其他任务中主动操控 Task1，常用操作 API：
vTaskSuspend(xHandleTask1)：挂起该任务vTaskResume(xHandleTask1)：恢复被挂起的任务vTaskDelete(xHandleTask1)：动态删除指定任务xTaskNotify(xHandleTask1, value, eSetBits)：通过任务通知定向唤醒该任务
⚠️ 注意：上面四个
vTask*/xTaskNotify都是任务上下文（task context）API，不能在中断服务函数（ISR）里直接调用。若在 ISR 中操控任务，必须使用对应的FromISR变体，例如vTaskResumeFromISR、xTaskNotifyFromISR等；vTaskSuspend/vTaskDelete在 ISR 中尤其危险，通常根本不该在中断里做挂起/删除操作。误用会触发 HardFault 或未定义行为。适用场景：业务中存在动态启停、暂停控制需求的任务，例如机器人电机控制任务、传感器采集任务，可通过遥控指令动态启停。
2. Task2 传入 NULL 的逻辑
传入
NULL代表程序不需要保存该任务的外部访问句柄；内核创建任务后，不会向外输出任务标识，外部代码无法主动操作、控制 Task2；
优势：无需额外定义全局 / 局部句柄变量，节省少量内存，代码更简洁；
适用场景：任务生命周期与系统完全同步，上电创建后持续运行、无需外部干预，例如日志打印、屏幕刷新等常驻后台任务。
两种传参方式快速对比：
| 维度 | 传&xHandleTask1 | 传NULL |
|---|---|---|
| 是否保存句柄 | 是 | 否 |
| 外部能否操控 | 能（挂起 / 恢复 / 删除 / 通知） | 不能 |
| 额外变量开销 | 需定义一个句柄变量 | 省一个变量 |
| 适用任务 | 需动态启停 / 外部控制 | 常驻后台、无需干预 |
三、补充关键知识点
3.1 两种传参方式不影响任务基础运行
无论传入变量地址还是NULL，任务本身都会正常调度、循环执行，二者仅区别于外部是否具备操控权限，不改变任务本身的调度逻辑。
3.2 任务内部获取自身句柄
即使创建时没有保存外部句柄，任务函数内部可调用 API 获取自身句柄：
voidTask2Function(void*pvParam){TaskHandle_t xSelfHandle=xTaskGetCurrentTaskHandle();while(1){// 业务逻辑}}该方式仅能在任务内部使用，无法实现跨任务操控。
3.3 任务创建失败时的变量状态
xTaskCreate存在创建失败场景（堆内存不足），可通过返回值判断结果：
返回
pdPASS：任务创建成功，句柄变量被正常赋值；返回
pdFALSE（实际为errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY，值为 0）：堆空间不足，任务创建失败，句柄变量不会被改写，避免非法句柄误操作。
示例判断逻辑：
BaseType_t xRet;TaskHandle_t xMotorTask;xRet=xTaskCreate(vMotorTask,"Motor",200,NULL,5,&xMotorTask);if(xRet!=pdPASS){printf("电机任务创建失败，堆内存不足\r\n");}四、工程选型规范（项目实操标准）
需要外部动态控制的任务（电机、采集、通信控制任务）：定义句柄变量，传入变量地址；
纯常驻、无启停需求的后台任务（日志、显示、心跳打印）：直接传入
NULL，精简代码；大型仿真 / 工业项目统一规范：高优先级核心控制任务全部保留句柄，低优先级辅助任务省略句柄。
五、总结
xTaskCreate第六参数为输出句柄指针，传&变量用于保存任务标识，支持跨任务动态操控；传
NULL表示无需外部操作该任务，简化代码、节省内存；句柄仅用于外部控制，不影响任务本身调度；任务内部可独立获取自身句柄；
工程开发时根据任务是否需要动态启停，选择对应传参方式，是 FreeRTOS 多任务开发基础规范。
