Edit

Share via

IoReadDiskSignature function (ntddk.h)

  • Article

The IoReadDiskSignature routine reads the disk signature information for the partition table of a disk.

Syntax

NTSTATUS IoReadDiskSignature(
  [in]  PDEVICE_OBJECT  DeviceObject,
  [in]  ULONG           BytesPerSector,
  [out] PDISK_SIGNATURE Signature
);

Parameters

[in] DeviceObject

Specifies the device object for the disk to read.

[in] BytesPerSector

Specifies the number of bytes per sector of the disk.

[out] Signature

Pointer to a DISK_SIGNATURE structure the routine uses to return the disk signature information.

Return value

The routine returns STATUS_SUCCESS on success, or the appropriate error code on failure. The routine returns STATUS_DISK_CORRUPT_ERROR if it detects that the disk partition table is corrupted.

Remarks

IoReadDiskSignature must only be used by disk drivers. Other drivers should use the IOCTL_DISK_GET_DRIVE_GEOMETRY_EX I/O request instead.

Requirements

Requirement Value
Minimum supported client This routine is only available on Windows XP and later.
Target Platform Universal
Header ntddk.h (include Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe

See also

DISK_SIGNATURE

IOCTL_DISK_GET_DRIVE_GEOMETRY_EX