NtDoc

No description available.

Windows Driver Kit DDI reference (ni-ntddvol-ioctl_volume_get_volume_disk_extents)

IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS IOCTL

Description

Returns the physical location(s) of a volume on one or more disks. Extents are initially stored in the order in which they are created, but remirroring, splitting, or breaking a mirror, or actions taken during disaster recovery, can affect the order of disk extents.

Parameters

Major code

Input buffer

None.

Input buffer length

None.

Output buffer

The driver returns a VOLUME_DISK_EXTENTS structure in the buffer at Irp->AssociatedIrp.SystemBuffer, which must be at least sizeof(VOLUME_DISK_EXTENTS).

Output buffer length

The length of a VOLUME_DISK_EXTENTS structure.

Input/output buffer

Input/output buffer length

Status block

The driver sets Irp->IoStatus.Information and the Status field as follows:

If the buffer at Irp->AssociatedIrp.SystemBuffer is < sizeof(VOLUME_DISK_EXTENTS), the driver sets Irp->IoStatus.Information to zero and returns STATUS_INVALID_PARAMETER.
If the buffer at Irp->AssociatedIrp.SystemBuffer is at least sizeof(VOLUME_DISK_EXTENTS) but too small for all data to be returned, the driver sets Irp->IoStatus.Information to sizeof(VOLUME_DISK_EXTENTS) and sets Status to STATUS_BUFFER_OVERFLOW.
If the buffer at Irp->AssociatedIrp.SystemBuffer is large enough for all data to be returned, the driver sets Irp->IoStatus.Information to sizeof(VOLUME_DISK_EXTENTS) + ((NumberOfDiskExtents - 1) * sizeof(DISK_EXTENT)) and sets Status to STATUS_SUCCESS.

Win32 API reference (ni-winioctl-ioctl_volume_get_volume_disk_extents)

IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS IOCTL

Description

Retrieves the physical location of a specified volume on one or more disks.

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

BOOL DeviceIoControl(
  (HANDLE) hDevice,                     // handle to device
  IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS, // 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
);

Parameters

Input buffer

Input buffer length

Output buffer

Output buffer length

Input/output buffer

Input/output 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

In Windows 8 and Windows Server 2012, this code is supported by the following technologies.

Technology	Supported
Server Message Block (SMB) 3.0 protocol	No
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 with Scale-out File Shares (SO)	No
Cluster Shared Volume File System (CsvFS)	Yes

IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS - NtDoc

NtDoc

Windows Driver Kit DDI reference (ni-ntddvol-ioctl_volume_get_volume_disk_extents)

IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS IOCTL

Description

Parameters

Major code

Input buffer

Input buffer length

Output buffer

Output buffer length

Input/output buffer

Input/output buffer length

Status block

See also

Win32 API reference (ni-winioctl-ioctl_volume_get_volume_disk_extents)

IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS IOCTL

Description

Parameters

Input buffer

Input buffer length

Output buffer

Output buffer length

Input/output buffer

Input/output buffer length

Status block

Remarks

See also