create_message_queue — Create a new empty message queue.
create_message_queue( : : : QueueHandle)
create_message_queue creates a new empty message queue.
The output parameter
QueueHandle is a handle to the newly created
message queue and is used to identify the queue in any subsequent operator
calls using the queue.
The message queues are designed as FIFO pipes delivering arbitrary sets of
data safely among different threads. The queue access is internally fully
synchronized, no explicit locking is required from the application.
The data is traveling through the queue in so called messages
Multiple producer threads can append data simultaneously
enqueue_message) while multiple consumer threads are simultaneously
retrieving the data again (
dequeue_message). Multiple messages
can be enqueued together using a single
In such case, those messages will travel together through the queue
and will be delivered through a single
All the enqueued messages are copied by the
enqueue_message operation. The original message(s) can thus be
immediately reused after the
enqueue_message call without affecting
the enqueued copy.
Handle of the newly created message queue.
Number of elements: QueueHandle == 1
QueueHandle != 0
create_message_queue (ProducerQueue) create_message_queue (ResultQueue) * ...
Returns 2 (H_MSG_TRUE) unless a resource allocation error occurs. Otherwise an exception is raised.