DosMonRead

Bindings:  C, MASM 

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: 

    0         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.