Creates an RT mailbox.
NTXHANDLE ntxCreateRtMailbox( NTXLOCATION hLocation, DWORD dwFlags );
hLocation
dwFlags
NTX_OBJECT_MAILBOX |
This flag indicates that the mailbox is to be created to pass RT object handles. It is mutually exclusive with the NTX_DATA_MAILBOX flag. The depth of the mailbox may be specified by the MAILBOX_DEPTH(n) macro. |
NTX_DATA_MAILBOX |
This flag indicates that the mailbox is to be created to pass up to 128-byte messages. In this case the depth of the mailbox is initially 3 messages. |
NTX_FIFO_QUEUING |
This flag indicates that threads will be queued in First-In-First-Out order on this object. |
NTX_PRIORITY_QUEUING |
This flag indicates that threads will be queued in priority order on this object. |
MAILBOX_DEPTH(n) |
This macro determines the number of objects which can be queued in an object mailbox. It is ignored for data mailboxes. The value n must be at least 8, at most 64, and a multiple of 4. |
NTX_BAD_NTXHANDLE
E_OK 0x0000
E_MEM 0x0002
E_LIMIT 0x0004
E_STATE 0x0007
E_LOCATION 0x8f02
Versions | Defined in | Include | Link to |
---|---|---|---|
INtime 3.0 | intime/nt/include/ntx.h | ntx.h | ntx.lib ntxext.lib |
INtime 4.01 (64-bit Windows) | intime/nt/include/ntx.h | ntx.h | ntx64.lib ntxext64.lib (for 64-bit Windows) |