Skip to content

Latest commit

 

History

History
98 lines (77 loc) · 3 KB

ni-winioctl-ioctl_storage_get_device_number.md

File metadata and controls

98 lines (77 loc) · 3 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist f1_keywords dev_langs topic_type api_type api_location api_name
NI:winioctl.IOCTL_STORAGE_GET_DEVICE_NUMBER
IOCTL_STORAGE_GET_DEVICE_NUMBER
Retrieves the device type, device number, and, for a partitionable device, the partition number of a device.
IOCTL_STORAGE_GET_DEVICE_NUMBER
IOCTL_STORAGE_GET_DEVICE_NUMBER control
IOCTL_STORAGE_GET_DEVICE_NUMBER control code
base.ioctl_storage_get_device_number
winioctl/IOCTL_STORAGE_GET_DEVICE_NUMBER
base\ioctl_storage_get_device_number.htm
base
2cd9610b-aa83-4d0a-a7a9-1d4dab8be331
12/05/2018
IOCTL_STORAGE_GET_DEVICE_NUMBER, IOCTL_STORAGE_GET_DEVICE_NUMBER control, IOCTL_STORAGE_GET_DEVICE_NUMBER control code, base.ioctl_storage_get_device_number, winioctl/IOCTL_STORAGE_GET_DEVICE_NUMBER
winioctl.h
Windows.h
Windows
Windows XP
Windows Server 2003
Windows
IOCTL_STORAGE_GET_DEVICE_NUMBER
winioctl/IOCTL_STORAGE_GET_DEVICE_NUMBER
c++
APIRef
kbSyntax
HeaderDef
WinIoCtl.h
IOCTL_STORAGE_GET_DEVICE_NUMBER

IOCTL_STORAGE_GET_DEVICE_NUMBER IOCTL

-description

Retrieves the device type, device number, and, for a partitionable device, the partition number of a device.

To perform this operation, call the DeviceIoControl function with the following parameters.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to device
  IOCTL_STORAGE_GET_DEVICE_NUMBER,  // dwIoControlCode
  NULL,                             // lpInBuffer
  0,                                // nInBufferSize
  (LPVOID), lpOutBuffer,            // output buffer
  (DWORD), nOutBufferSize,          // size of output buffer
  (LPDWORD) lpBytesReturned,        // number of bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

-ioctlparameters

-input-buffer

-input-buffer-length

-output-buffer

-output-buffer-length

-in-out-buffer

-inout-buffer-length

-status-block

Irp->IoStatus.Status is set to STATUS_SUCCESS if the request is successful.

Otherwise, Status to the appropriate error condition as a NTSTATUS code.

For more information, see NTSTATUS Values.

-remarks

The values in the STORAGE_DEVICE_NUMBER structure are guaranteed to remain unchanged until the device is removed or the system is restarted. It is not guaranteed to be persistent across device restarts or system restarts.

-see-also