Returns a pointer to the internal dispatcher array entry containing the specified wait object.
DWORD dispFindWaitObject (CTAQUEUEHD ctaQueueHd, CTA_WAITOBJ* pctaWaitObj, CTA_WAITOBJ** ppctaWaitObjFound)
|
Argument |
Description |
|
ctaQueueHd |
Queue handle. |
|
pctaWaitObj |
Pointer to a wait object. |
|
ppctaWaitObjFound |
Pointer to the returned entry containing the wait object. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
Wait object is not associated with a queue. |
|
CTAERR_INVALID_CTAQUEUEHD |
ctaQueueHd is invalid. |
|
CTAERR_NOT_INITIALIZED |
Natural Access was not initialized. |
dispFindWaitObject returns the address of the internal array entry where the matching wait object is located. This function is currently needed for NMS's abstracted IPC communications layer (TSI library).