Update comments

This commit is contained in:
kar-rahul-aws 2024-04-16 12:24:10 +05:30
parent 6e1b7a3519
commit ea90347741
2 changed files with 18 additions and 2 deletions

View file

@ -768,6 +768,10 @@ typedef StreamBufferHandle_t MessageBufferHandle_t;
* *
* A message buffer can only be reset if there are no tasks blocked on it. * A message buffer can only be reset if there are no tasks blocked on it.
* *
* Use xMessageBufferReset() to reset a message buffer from a task.
* Use xMessageBufferResetFromISR() to reset a maessage buffer from an
* interrupt service routine (ISR).
*
* configUSE_STREAM_BUFFERS must be set to 1 in for FreeRTOSConfig.h for * configUSE_STREAM_BUFFERS must be set to 1 in for FreeRTOSConfig.h for
* xMessageBufferReset() to be available. * xMessageBufferReset() to be available.
* *
@ -791,12 +795,16 @@ typedef StreamBufferHandle_t MessageBufferHandle_t;
* BaseType_t xMessageBufferResetFromISR( MessageBufferHandle_t xMessageBuffer ); * BaseType_t xMessageBufferResetFromISR( MessageBufferHandle_t xMessageBuffer );
* @endcode * @endcode
* *
* An interrupt safe version of the API function that reset the stream buffer. * An interrupt safe version of the API function that resets the stream buffer.
* Resets a message buffer to its initial empty state, discarding any message it * Resets a message buffer to its initial empty state, discarding any message it
* contained. * contained.
* *
* A message buffer can only be reset if there are no tasks blocked on it. * A message buffer can only be reset if there are no tasks blocked on it.
* *
* Use xMessageBufferReset() to reset a message buffer from a task.
* Use xMessageBufferResetFromISR() to reset a maessage buffer from an
* interrupt service routine (ISR).
*
* configUSE_STREAM_BUFFERS must be set to 1 in for FreeRTOSConfig.h for * configUSE_STREAM_BUFFERS must be set to 1 in for FreeRTOSConfig.h for
* xMessageBufferResetFromISR() to be available. * xMessageBufferResetFromISR() to be available.
* *

View file

@ -767,6 +767,10 @@ BaseType_t xStreamBufferIsEmpty( StreamBufferHandle_t xStreamBuffer ) PRIVILEGED
* are no tasks blocked waiting to either send to or receive from the stream * are no tasks blocked waiting to either send to or receive from the stream
* buffer. * buffer.
* *
* Use xStreamBufferReset() to reset a stream buffer from a task.
* Use xStreamBufferResetFromISR() to reset a stream buffer from an
* interrupt service routine (ISR).
*
* configUSE_STREAM_BUFFERS must be set to 1 in for FreeRTOSConfig.h for * configUSE_STREAM_BUFFERS must be set to 1 in for FreeRTOSConfig.h for
* xStreamBufferReset() to be available. * xStreamBufferReset() to be available.
* *
@ -788,13 +792,17 @@ BaseType_t xStreamBufferReset( StreamBufferHandle_t xStreamBuffer ) PRIVILEGED_F
* BaseType_t xStreamBufferResetFromISR( StreamBufferHandle_t xStreamBuffer ); * BaseType_t xStreamBufferResetFromISR( StreamBufferHandle_t xStreamBuffer );
* @endcode * @endcode
* *
* An interrupt safe version of the API function that reset the stream buffer. * An interrupt safe version of the API function that resets the stream buffer.
* *
* Resets a stream buffer to its initial, empty, state. Any data that was in * Resets a stream buffer to its initial, empty, state. Any data that was in
* the stream buffer is discarded. A stream buffer can only be reset if there * the stream buffer is discarded. A stream buffer can only be reset if there
* are no tasks blocked waiting to either send to or receive from the stream * are no tasks blocked waiting to either send to or receive from the stream
* buffer. * buffer.
* *
* Use xStreamBufferReset() to reset a stream buffer from a task.
* Use xStreamBufferResetFromISR() to reset a stream buffer from an
* interrupt service routine (ISR).
*
* configUSE_STREAM_BUFFERS must be set to 1 in for FreeRTOSConfig.h for * configUSE_STREAM_BUFFERS must be set to 1 in for FreeRTOSConfig.h for
* xStreamBufferResetFromISR() to be available. * xStreamBufferResetFromISR() to be available.
* *