en:docs:fapi:dosdevioctl
no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.


Previous revision
Next revision
—en:docs:fapi:dosdevioctl [2020/12/04 13:04] – prokushev
Line 1: Line 1:
 +{{logos:os2.gif?35x35}} {{logos:dos.gif?35x35}}
 +
 +====== DosDevIOCtl ======
 +
 +This call performs control functions on a device specified by an opened device handle.
 +
 +==Syntax==
 + DosDevIOCtl (Data, ParmList, Function, Category, DevHandle)
 +
 +==Parameters==
 +;Data (PVOID) - input : Address of the data area.
 +;ParmList (PVOID) - input : Address of the command-specific argument list.
 +;Function (USHORT) - input : Device-specific function code.
 +;Category (USHORT) - input : Device category.
 +;DevHandle (HFILE) - input : Device handle returned by DosOpen or a standard (open) device handle.
 +
 +==Return Code==
 + rc (USHORT) - return
 +Return code descriptions are:
 +* 0  NO_ERROR
 +* 1  ERROR_INVALID_FUNCTION 
 +* 6  ERROR_INVALID_HANDLE 
 +* 15  ERROR_INVALID_DRIVE 
 +* 31  ERROR_GEN_FAILURE 
 +* 87  ERROR_INVALID_PARAMETER 
 +* 115  ERROR_PROTECTION_VIOLATION 
 +* 117  ERROR_INVALID_CATEGORY 
 +* 119  ERROR_BAD_DRIVER_LEVEL 
 +* 163  ERROR_UNCERTAIN_MEDIA 
 +* 165  ERROR_MONITORS_NOT_SUPPORTED
 +
 +==Remarks==
 +Values returned in the range hex FF00 through FFFF are user dependent error codes. Values returned in the range hex FE00 through FEFF are device driver dependent error codes.
 +
 +Refer to the ''IBM Operating System/2 Version 1.2 I/O Subsystems And Device Support Volume 1'' for a complete listing of control functions (DevHlp calls). 
 +
 +===Family API Considerations===
 +Some options operate differently in the DOS mode than in the OS/2 mode. Therefore, the following considerations apply to DosDevIOCtl when coding for the DOS mode.
 +
 +The level of support for DosDevIOCtl is identified by category and function code with a noted restriction if it is not supported by DOS 2.X or DOS 3.X Functions tend to be more restrictive in lower version numbers of DOS.
 +
 +*Category 1 supported as follows:
 +**41H Set Baud Rate
 +**42H Set Line Control
 +**All other category 1 functions are not supported for DOS 2.X and DOS 3.X. 
 +*Category 2 not supported in FAPI
 +*Category 3 not supported in FAPI
 +*Category 4 not supported in FAPI
 +*Category 5 supported in FAPI as follows:
 +**42H Set Frame control - supports IBM Graphics Printers only
 +**44H Set Infinite Retry - for DOS 2.X and DOS 3.X, the function is in effect only for the duration of the calling program
 +**46H Initialize printer
 +**62H Get Frame Control - not supported for DOS 2.X and DOS 3.X
 +**64H Get Infinite Retry
 +**66H Get Printer Status.
 +*Category 6 not supported in FAPI
 +*Category 7 not supported in FAPI
 +*Category 8 supported in FAPI as follows:
 +**00H Lock Drive - not supported for versions below DOS 3.2
 +**01H Unlock Drive - not supported for versions below DOS 3.2
 +**02H Redetermine Media - not supported for versions below DOS 3.2
 +**03H Set Logical Map - not supported for versions below DOS 3.2
 +**20H Block Removable - not supported for versions below DOS 3.2
 +**21H Get Logical Map - not supported for versions below DOS 3.2
 +**43H Set Device Parameters - not supported for DOS 2.X and DOS 3.X
 +**44H Write Track - not supported for DOS 2.X and DOS 3.X
 +**45H Format Track - not supported for DOS 2.X and DOS 3.X
 +**63H Get Device Parameters - not supported for DOS 2.X and DOS 3.X
 +**64H Read Track - not supported for DOS 2.X and DOS 3.X
 +**65H Verify Track - not supported for DOS 2.X and DOS 3.X. 
 +*Category 9 is reserved
 +*Category 10 (0AH) not supported in FAPI
 +*Category 11 (0BH) not supported in FAPI.
 +
 +==Example Code==
 +===C Binding===
 +<PRE>
 +#define INCL_DOSDEVICES
 +
 +USHORT  rc = DosDevIOCtl(Data, ParmList, Function, Category, DevHandle);
 +
 +PVOID            Data;          /* Data area */
 +PVOID            ParmList;      /* Command arguments */
 +USHORT           Function;      /* Device function */
 +USHORT           Category;      /* Device category */
 +HFILE            DevHandle;     /* Specifies the device */
 +
 +USHORT           rc;            /* return code */
 +</PRE>
 +
 +===MASM Binding===
 +<PRE>
 +EXTRN  DosDevIOCtl:FAR
 +INCL_DOSDEVICES     EQU 1
 +
 +PUSH@  OTHER   Data          ;Data area
 +PUSH@  OTHER   ParmList      ;Command arguments
 +PUSH   WORD    Function      ;Device function
 +PUSH   WORD    Category      ;Device category
 +PUSH   WORD    DevHandle     ;Device handle
 +CALL   DosDevIOCtl
 +
 +Returns WORD
 +</PRE>
 +
 +
 +====== Note ======
 +
 +Text based on [[http://www.edm2.com/index.php/DosDevIOCtl_(FAPI)]]
 +
 +{{page>en:templates:fapi}}