BOOL osQueuePost( HANDLE Handle, PVOID Buffer );
The handle to the queue object.
A pointer to the buffer containing the message to be written.
Returns TRUE on success or FALSE on failure. Call the osGetLastError function to obtain extended error information.
This function appends a message to the end of the queue. If the queue is full, the function will fail immediately unless the OS_IPC_WAIT_IF_FULL mode flag was specified during creation. If enabled, the calling task will block until space becomes available. When a task is waiting, the maximum number of messages is set to 0, and direct read-write access is enabled (via the OS_IPC_DIRECT_READ_WRITE mode flag), data is transferred directly from the sending task to the receiving task, bypassing the internal buffer.
For further details regarding queues, refer to the queue objects section.
This function is available only when the OS_USE_QUEUE and OS_QUEUE_POST_PEND_FUNC constants are both set to 1.
| Version: | 1.0 |
|---|---|
| Header file: | OS_Queue.h (include OS_API.h) |
| See also: | BOOL, FALSE, HANDLE, OS_IPC_DIRECT_READ_WRITE, OS_IPC_WAIT_IF_FULL, OS_USE_QUEUE, osCreateQueue, osGetLastError, osQueuePost, osQueuePeek, PVOID, queues, TRUE |