Creates a message queue object. The threshold and queue size determine the number of messages which may be received in the queue object.

NTXHANDLE ntxCreateRtQueue(
    NTXLOCATION loc,
    DWORD queueSize,
    DWORD msgThreshold,
    DWORD flags); 

Parameters

loc

The location of the node where the queue is to be created.

queueSize

The total size of the queue buffer. Note that there is an overhead of 30 bytes per message in the buffer.
This value must be at least 32 bytes.

msgThreshold

The maximum number of bytes in a short message in this queue. Messages longer than this will be delivered as long messages. This is an arbitrary value which determines the method used to send the message. If you do not wish to send short messages, this value may be set to 0 which will force all messages to be sent as long messages.

flags

(reserved for future use, set to 0).

Returns

Returns a valid queue handle on success, or else NTX_BAD_NTXHANDLE to indicate failure. The failure status is returned from ntxGetLastRtError(). Status codes returned from this call include:

Requirements