vTaskDelay

task. h

 
 

  
  void vTaskDelay( portTickType xTicksToDelay );
 
 

INCLUDE_vTaskDelay必须设置为1，这个函数才为可用。参考配置获得更多信息。

延时任务为已知时间片。任务被锁住剩余的实际时间由时间片率决定。portTICK_RATE_MS常量用来用来从时间片速率（一片周期代表着分辨率）来计算实际时间。

vTaskDelay()指定一个任务希望的时间段，这个时间之后（调用vTaskDelay() ）任务解锁。例如，指定周期段为100时间片，将使任务在调用vTaskDelay()100个时间片之后解锁。vTaskDelay()不提供一个控制周期性任务频率的好方法，像通过代码采取的路径，和其他任务和中断一样，在调用vTaskDelay()后 影响频率，因此任务所需的时间下一次执行。

参考 vTaskDelayUntil() ，这个交替的API函数设计了执行固定的频率。它是指定的一个绝对时间（而不是一个相对时间）后，调用任务解锁。

参数:

xTicksToDelay

时间数量，调用任务应该锁住的时间片周期

  （如果为0，导致强制一个重新的任务切换） /* A delay time of zero just forces a reschedule. */

使用例子:

 
 void vTaskFunction( void * pvParameters )
 {
 /* 挂起500ms. */
 const portTickType xDelay = 500 / portTICK_RATE_MS;

     for( ;; )
     {
         /* 简单的每 500ms触发LED, .在每两次触发间挂起*/
         vToggleLED();
         vTaskDelay( xDelay );
     }
}