Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

IoGetBootDiskInformation routine

The IoGetBootDiskInformation routine returns information describing the boot and system disks.

Syntax


NTSTATUS IoGetBootDiskInformation(
  _Inout_ PBOOTDISK_INFORMATION BootDiskInformation,
  _In_    ULONG                 Size
);

Parameters

BootDiskInformation [in, out]

Pointer to a caller-allocated buffer that the routine uses to return information about the boot and system disks. The routine fills this buffer in with either a BOOTDISK_INFORMATION or a BOOTDISK_INFORMATION_EX structure.

Size [in]

Specifies the size, in bytes, of the buffer specified by BootDiskInformation. Should be either sizeof(BOOTDISK_INFORMATION) or sizeof(BOOTDISK_INFORMATION_EX).

Return value

IoGetBootDiskInformation returns one of the following status values:

Return codeDescription
STATUS_SUCCESS

The routine successfully returned the requested information in the buffer specified by BootDiskInformation.

STATUS_INVALID_PARAMETER

The value of Size is less than the size, in bytes, of a BOOTDISK_INFORMATION structure.

STATUS_TOO_LATE

The driver called the routine after the system has already booted. Only boot and system drivers can call IoGetBootDiskInformation, and then only in their DriverEntry or AddDevice routines.

 

Remarks

IoGetBootDiskInformation can be called only by a boot driver. This driver should call IoGetBootDiskInformation in a Reinitialize callback routine that the driver registers by calling the IoRegisterBootDriverReinitialization routine.

On Windows XP and later versions of Windows, if the Size parameter is sizeof(BOOTDISK_INFORMATION_EX) or larger, the routine returns a BOOTDISK_INFORMATION_EX structure in the BootDiskInformation buffer. Otherwise, if Size is at least sizeof(BOOTDISK_INFORMATION), the routine returns a BOOTDISK_INFORMATION structure.

On Windows 2000, the routine returns only the BOOTDISK_INFORMATION structure.

Requirements

Target platform

Universal

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

<= APC_LEVEL

See also

BOOTDISK_INFORMATION
BOOTDISK_INFORMATION_EX
IoRegisterBootDriverReinitialization
Reinitialize

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft