DosWriteQueue

This call adds an element to a queue.

DosWriteQueue

(QueueHandle, Request, DataLength, DataBuffer, ElemPriority)

QueueHandle (HQUEUE) - input

Queue handle.
Request (USHORT) - input
A value to be passed with the queue element. This word is used for event encoding by the specific application.
DataLength (USHORT) - input
Length of the data being sent to the queue.
DataBuffer (PBYTE) - input
Address of the data buffer where data, that is to be placed in the queue, is located.
ElemPriority (UCHAR) - input
Priority of the element being added to the queue. If the priority is specified as 15, the element is added to the top of the queue (that is, in LIFO order). If the priority is specified as 0, the element is added as the last element in the queue (that is, in FIFO order). Elements with the same priority are in FIFO order. This parameter is valid for priority-type queues only.
rc (USHORT) - return
Return code descriptions are:
• NO_ERROR 334
  ERROR_QUE_NO_MEMORY
  337
  ERROR_QUE_INVALID_HANDLE
  Remarks

  DosWriteQueue adds entries to a specified queue.

  The Request, DataLength and DataBuffer parameters contain data understood by the thread adding the element to the queue and by the thread that receives the queue element. There is no special meaning to this data; applications may use these parameters for any purpose they wish. OS/2 does not alter this data; it simply copies this data intact. OS/2 does not validate the address of DataBuffer or the DataLength.

  If the queue owner has defined a semaphore for use in its notification when elements are added to the queue and if that semaphore is a RAM semaphore, then that semaphore must be in a segment which is shared among both the queue owner's process and this process. If that semaphore handle is for a system semaphore, then that semaphore must be opened by this process before making a DosWriteQueue request to the queue.

  If the owning process is terminated, or if the queue is closed before this request is issued, ERROR_QUE_INVALID_HANDLE is returned.

  If the owning process invokes a system semaphore when DosReadQueue or DosPeekQueue is issued, other processes that issue DosWriteQueue must first issue DosOpenSem to access the system semaphore.

  ---

  [Back: DosWriteAsync]
  [Next: DosAllocHuge]