Differences

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

--- en:docs:fapi:dosdevioctl2 [2021/08/20 04:38] – prokushev
+++ en:docs:fapi:dosdevioctl2 [2023/11/26 12:37] (current) – [Remarks] prokushev
@@ Line 1: / Line 1: @@
 {{page>en:templates:fapiint}}
+====== DosDevIOCtl2 ======
 This call performs control functions on a device specified by an opened device handle.
-==Syntax==
+===== Syntax =====
+<code c>
  DosDevIOCtl2 (Data, DataLength, ParmList, ParmListLength,
                Function, Category, DevHandle)
+</code>
+===== Parameters =====
-==Parameters==
+  * Data ([[PVOID]]) - input : Address of the data area.
-;Data ([[PVOID]]) - input : Address of the data area.
+  * DataLength ([[USHORT]]) - input : Length of the data buffer.
-;DataLength ([[USHORT]]) - input : Length of the data buffer.
+  * ParmList ([[PVOID]]) - input : Address of the command-specific argument list.
-;ParmList (PVOID) - input : Address of the command-specific argument list.
+  * ParmListLength ([[USHORT]]) - input : Length of the command-specific argument list.
-;ParmListLength (USHORT) - input : Length of the command-specific argument list.
+  * Function ([[USHORT]]) - input : Device-specific function code.
-;Function (USHORT) - input : Device-specific function code.
+  * Category ([[USHORT]]) - input : Device category.
-;Category (USHORT) - input : Device category.
+  * DevHandle ([[HFILE]]) - input : Device handle returned by DosOpen or a standard (open) device handle.
-;DevHandle ([[HFILE]]) - input : Device handle returned by DosOpen or a standard (open) device handle.
-==Return Code==
+===== Return Code =====
-;rc (USHORT) - return:Return code descriptions are:
-* 0 NO_ERROR
+rc ([[USHORT]]) - return:Return code descriptions are:
-* 1 ERROR_INVALID_FUNCTION
-* 6 ERROR_INVALID_HANDLE
+  * 0 NO_ERROR
-*15 ERROR_INVALID_DRIVE
+  * 1 ERROR_INVALID_FUNCTION
-*31 ERROR_GEN_FAILURE
+  * 6 ERROR_INVALID_HANDLE
-*87 ERROR_INVALID_PARAMETER
+  *15 ERROR_INVALID_DRIVE
-*115 ERROR_PROTECTION_VIOLATION
+  *31 ERROR_GEN_FAILURE
-*117 ERROR_INVALID_CATEGORY
+  *87 ERROR_INVALID_PARAMETER
-*119 ERROR_BAD_DRIVER_LEVEL
+  *115 ERROR_PROTECTION_VIOLATION
-*163 ERROR_UNCERTAIN_MEDIA
+  *117 ERROR_INVALID_CATEGORY
-*165 ERROR_MONITORS_NOT_SUPPORTED
+  *119 ERROR_BAD_DRIVER_LEVEL
+  *163 ERROR_UNCERTAIN_MEDIA
+  *165 ERROR_MONITORS_NOT_SUPPORTED
+===== Remarks =====
-==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).
+Refer to the [[http://www.os2museum.com/files/docs/os212pti/64F3959_OS2_V1_2_PTI_IO_Subsystems_and_Device_Support_Vol_1_Device_Drivers.pdf|IBM Operating System/2 Version 1.2 I/O Subsystems And Device Support Volume 1]] for a complete listing of control functions (DevHlp calls).
 This function provides a generic, expandable IOCTL facility.
@@ Line 45: / Line 52: @@
 Do not pass a non-null pointer with a zero length.
-==Bindings==
+===== Bindings =====
-===C===
-<PRE>
+==== C ====
+<code c>
 #define INCL_DOSDEVICES
@@ Line 61: / Line 70: @@
 USHORT  rc;            /* return code */
-</PRE>
+</code>
-===MASM===
+==== MASM ====
-<PRE>
+<code asm>
 EXTRN  DosDevIOCtl2:FAR
 INCL_DOSDEVICES     EQU 1
@@ Line 77: / Line 87: @@
 CALL   DosDevIOCtl2
-Returns WORD
+</code>
-</PRE>
+Returns WORD
 {{page>en:templates:fapi}}