Previous

Next

Function RTUGetMsgQ

RTUGetMsgQ waits for and retrieves a message pointer from a queue:

RTUSBMessage * RTUGetMsgQ(RTUQHandle Queue);

Parameters

Queue

Handle to the queue from which the pointer shall be retrieved.

return value

Pointer to the retrieved message.

Message buffers posted by RTUSB-32 (as opposed to messages posted by a client using RTUPutMsgQ) should be released to RTUSB-32's free buffer pool using RTUFreeBuffer.

RTUGetMsgQ implements a blocking wait. The calling thread consumes no CPU time while it waits. If it is called while one or more messages are in the queue, the function returns immediately and does not wait.

Message Queues

Function RTUPutMsgQ

Function RTUGetMsgQTimed