DosMonRead

This call waits for and moves a data record from the input buffer of a registered character device monitor and places it in a private data area where the monitor can freely access it.

DosMonRead

(BufferI, WaitFlag, DataBuffer, Bytecnt)

BufferI (PBYTE) - input

Address of the monitor input buffer.
WaitFlag (UCHAR) - input
Valid values are:

Value

Definition
0
The monitor thread that issues DosMonRead wishes to block until a data record is available in its input buffer.
1
The monitor thread that issues DosMonRead does not wish to block when its input buffer is empty.
DataBuffer (PBYTE) - input
Address of the buffer in the calling process address space that the data from the monitor's input buffer is read into. The length of DataBuffer must be the entry value of Bytecnt.
Bytecnt (PUSHORT) - input/output
Address of the length of DataBuffer, on entry to DosMonRead. On the return from DosMonRead, Bytecnt specifies the number of bytes of data moved.
rc (USHORT) - return
Return code descriptions are:
• NO_ERROR 379
  ERROR_MON_INVALID_PARMS
  382
  ERROR_MON_BUFFER_TOO_SMALL
  383
  ERROR_MON_BUFFER_EMPTY
  Remarks

  For a detailed description of this call see the chapter "Character Device Monitors" in the IBM Operating System/2 Version 1.2 I/O Subsystems And Device Support Volume 1.

  ---

  [Back: DosMonOpen]
  [Next: DosMonReg]