void vTaskSetTimeOutState( TimeOut_t * const pxTimeOut );
This function is intended for advanced users only.
A task can enter the Blocked state to wait for an event. Typically, the task
will not wait in the Blocked state indefinitely, but instead a timeout period
will be specified. The task will be removed from the Blocked state if the
timeout period expires before the event the task is waiting for occurs.
If a task enters and exits the Blocked state more than once while it is waiting
for the event to occur then the timeout used each time the task enters the
Blocked state must be adjusted to ensure the total of all the time spent in the
Blocked state does not exceed the originally specified timeout period.
xTaskCheckForTimeOut() performs the adjustment, taking into account occasional
occurrences such as tick count overflows, which would otherwise make a manual
adjustment prone to error.
vTaskSetTimeOutState() is used with xTaskCheckForTimeOut(). vTaskSetTimeOutState()
is called to set the initial condition, after which xTaskCheckForTimeOut() can
be called to check for a timeout condition, and adjust the remaining block time
if a timeout has not occurred.
A pointer to a structure that will be initialized to hold
information necessary to determine if a timeout has occurred.
An example is provided on the xTaskCheckForTimeOut()
Copyright (C) 2004-2010 Richard Barry. Copyright (C) 2010-2016 Real Time Engineers Ltd.
Any and all data, files, source code, html content and documentation included in the FreeRTOSTM distribution or available on this site are the exclusive property of Real Time Engineers Ltd..
See the files license.txt (included in the distribution) and this copyright notice for more information. FreeRTOSTM and FreeRTOS.orgTM are trade marks of Real Time Engineers Ltd.