ioctl12.hlp (Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
PRT_GETPRINTERSTATUS (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSDEVIOCTL
 
USHORT DosDevIOCtl(pfStatus, pbCommand, 0x0066, 0x0005, hDevice)
PBYTE pfStatus;     /* pointer to printer status flag   */
PBYTE pbCommand;    /* pointer to variable with command */
HFILE hDevice;      /* device handle                    */
 
The PRT_GETPRINTERSTATUS function retrieves the status of a printer.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
pfStatus   Points to the variable that receives the printer status. This
           variable can be a combination of the following values:
 
           Value                 Meaning
           ─────────────────────────────────────────────────────────────────
           PRINTER_TIMEOUT       Time-out occurred.
 
           PRINTER_IO_ERROR      I/O error occurred.
 
           PRINTER_SELECTED      Printer selected.
 
           PRINTER_OUT_OF_PAPER  Printer out of paper.
 
           PRINTER_ACKNOWLEDGED  Printer acknowledged.
 
           PRINTER_NOT_BUSY      Printer not busy.
 
pbCommand  Points to the variable that contains a reserved value. The value
           must be zero.
 
hDevice    Identifies the printer that receives the device-control function.
           The handle must have been created previously by using the
           DosOpen function.
 
Return Value
 
The return value is zero if the function is successful or an error value if
an error occurs.
 
See Also
 
DosOpen