function (ULONG) - input

The type of information to obtain about the partitionable disks.

Possible values are shown in the following list:

• INFO_COUNT_PARTITIONABLE_DISKS
  Obtain the total number of partitionable disks.

• INFO_GETIOCTLHANDLE
  Obtain a handle to use with Category 09h Physical Disk Control IOCtl Commands.

• INFO_FREEIOCTLHANDLE
  Release a handle for a partitionable disk.

pBuf (PVOID) - input

The address of the buffer where the returned information is placed.

The output data for each function is shown in the following list (all lengths are in bytes):

ÚÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿³Function  ³DataLen   ³Returned Information                    ³
ÃÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ 1        ³ 2        ³Total number of partitionable disks in  ³
³          ³          ³the system (1-based).                   ³
ÃÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ 2        ³ 2        ³Handle for the specified partitionable  ³
³          ³          ³disk for the Category 09h Physical Disk ³
³          ³          ³Control IOCtl Commands.                 ³
ÃÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ 3        ³ 0        ³None - pointer must be zero.            ³
ÀÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

cbBuf (ULONG) - input

The length, in bytes, of the data buffer.

pParams (PVOID) - input

The address of the buffer used for input parameters.

The input parameters required for each function are as follows (all lengths are in bytes):

ÚÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿³Function  ³ParmLen      ³Input Parameters                     ³
ÃÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ 1        ³ 0           ³None - must be set to zero.          ³
ÃÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ 2        ³string length³ASCIIZ string that specifies the     ³
³          ³             ³partitionable disk.                  ³
ÃÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ 3        ³ 2           ³Handle obtained from Function 2.     ³
ÀÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

The ASCIIZ string used to specify the partitionable disk must be of the following format:

number : <null byte>

Where:

number

specifies the partitionable disk number (1-based) in ASCII.
colon ( : )
must be present.
<null byte>
is the byte of zero for the ASCIIZ string.

cbParams (ULONG) - input

The length, in bytes, of the parameter buffer.

ulrc (APIRET) - returns

Return Code.

DosPhysicalDisk returns one of the following values:

• NO_ERROR 1
  ERROR_INVALID_FUNCTION
  87
  ERROR_INVALID_PARAMETER
  For a full list of error codes, see Errors.

---

[Back] [Next]