len0rd/FreeRTOS-Kernel
1
0
Fork 0
mirror of https://github.com/FreeRTOS/FreeRTOS-Kernel.git synced 2025-04-19 21:11:57 -04:00
Code Issues Packages Projects Releases Wiki Activity

Update comments related to portYIELD_FROM_ISR() in queue.h #925

Browse source
This commit is contained in:
Soren Ptak 2023-12-15 12:34:52 -05:00 committed by GitHub
parent 1384c68dc7
commit 553b0ad5d3
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 17 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
include/queue.h
View file

@ -1185,9 +1185,12 @@ void vQueueDelete( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION;
* { * {
* // Writing to the queue caused a task to unblock and the unblocked task * // Writing to the queue caused a task to unblock and the unblocked task
* // has a priority higher than or equal to the priority of the currently * // has a priority higher than or equal to the priority of the currently
* // executing task (the task this interrupt interrupted). Perform a context * // executing task (the task this interrupt interrupted). Perform a context
* // switch so this interrupt returns directly to the unblocked task. * // switch so this interrupt returns directly to the unblocked task.
* portYIELD_FROM_ISR(); // or portEND_SWITCHING_ISR() depending on the port. * // The macro used is port specific and will be either
* // portYIELD_FROM_ISR() or portEND_SWITCHING_ISR() - refer to the documentation
* // page for the port being used.
* portYIELD_FROM_ISR( xHigherPriorityTaskWoken );
* } * }
* } * }
* @endcode * @endcode
@ -1260,8 +1263,11 @@ void vQueueDelete( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION;
* // Now the buffer is empty we can switch context if necessary. * // Now the buffer is empty we can switch context if necessary.
* if( xHigherPriorityTaskWoken ) * if( xHigherPriorityTaskWoken )
* { * {
* // Actual macro used here is port specific. * // As xHigherPriorityTaskWoken is now set to pdTRUE then a context
* portYIELD_FROM_ISR (); * // switch should be requested. The macro used is port specific and
* // will be either portYIELD_FROM_ISR() or portEND_SWITCHING_ISR() -
* // refer to the documentation page for the port being used.
* portYIELD_FROM_ISR( xHigherPriorityTaskWoken );
* } * }
* } * }
* @endcode * @endcode
@ -1337,11 +1343,14 @@ void vQueueDelete( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION;
* *
* } while( portINPUT_BYTE( BUFFER_COUNT ) ); * } while( portINPUT_BYTE( BUFFER_COUNT ) );
* *
* // Now the buffer is empty we can switch context if necessary. Note that the * // Now the buffer is empty we can switch context if necessary.
* // name of the yield function required is port specific.
* if( xHigherPriorityTaskWokenByPost ) * if( xHigherPriorityTaskWokenByPost )
* { * {
* portYIELD_FROM_ISR(); * // As xHigherPriorityTaskWokenByPost is now set to pdTRUE then a context
* // switch should be requested. The macro used is port specific and
* // will be either portYIELD_FROM_ISR() or portEND_SWITCHING_ISR() -
* // refer to the documentation page for the port being used.
* portYIELD_FROM_ISR( xHigherPriorityTaskWokenByPost );
* } * }
* } * }
* @endcode * @endcode

2
tasks.c
View file

@ -3463,7 +3463,7 @@ static void prvInitialiseNewTask( TaskFunction_t pxTaskCode,
/* Mark that a yield is pending in case the user is not /* Mark that a yield is pending in case the user is not
* using the return value to initiate a context switch * using the return value to initiate a context switch
* from the ISR using portYIELD_FROM_ISR. */ * from the ISR using the port specific portYIELD_FROM_ISR(). */
xYieldPendings[ 0 ] = pdTRUE; xYieldPendings[ 0 ] = pdTRUE;
} }
else else