procedure Message_Queue_Get_Number_Pending ( ID : in RTEMS.ID; Count : out RTEMS.Unsigned32; Result : out RTEMS.Status_Codes );
RTEMS.SUCCESSFUL
- number of messages pending returned successfully
RTEMS.INVALID_ID
- invalid queue id
This directive returns the number of messages pending on this message queue in count. If no messages are present on the queue, count is set to zero.
Getting the number of pending messages on a global message queue which does not reside on the local node will generate a request to the remote node to actually obtain the pending message count for the specified message queue.
Copyright © 1988-2004 OAR Corporation