Chapter 2. API Reference
(continued from previous page)
// ...
// The created task will not run during this period, unless
// another task calls vTaskResume( xHandle ).
//...
// Suspend ourselves.
vTaskSuspend( NULL );
// We cannot get here unless another task calls vTaskResume
// with our handle as the parameter.
}
Parameters
• xTaskToSuspend: Handle to the task being suspended. Passing a NULL handle will cause the
calling task to be suspended.
void vTaskResume(TaskHandle_t xTaskToResume)
INCLUDE_vTaskSuspend must be defined as 1 for this function to be available. See the configuration section
for more information.
Resumes a suspended task.
A task that has been suspended by one or more calls to vTaskSuspend () will be made available for running
again by a single call to vTaskResume ().
Example usage:
void vAFunction( void )
{
TaskHandle_t xHandle;
// Create a task, storing the handle.
xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle␣
,→);
// ...
// Use the handle to suspend the created task.
vTaskSuspend( xHandle );
// ...
// The created task will not run during this period, unless
// another task calls vTaskResume( xHandle ).
//...
// Resume the suspended task ourselves.
vTaskResume( xHandle );
// The created task will once again get microcontroller processing
// time in accordance with its priority within the system.
}
Parameters
• xTaskToResume: Handle to the task being readied.
BaseType_t xTaskResumeFromISR(TaskHandle_t xTaskToResume)
INCLUDE_xTaskResumeFromISR must be defined as 1 for this function to be available. See the configuration
Espressif Systems 863
Submit Document Feedback
Release v4.4