IoGetBootDiskInformation 函数 (wdm.h)
IoGetBootDiskInformation 例程返回描述启动磁盘和系统磁盘的信息。
语法
NTSTATUS IoGetBootDiskInformation(
[in, out] PBOOTDISK_INFORMATION BootDiskInformation,
[in] ULONG Size
);
参数
[in, out] BootDiskInformation
指向调用方分配的缓冲区的指针,该缓冲区的例程用于返回有关启动磁盘和系统磁盘的信息。 例程使用 BOOTDISK_INFORMATION 或 BOOTDISK_INFORMATION_EX 结构填充此缓冲区。
[in] Size
指定由 BootDiskInformation指定的缓冲区的大小(以字节为单位)。 应为 sizeof(BOOTDISK_INFORMATION)或 sizeof(BOOTDISK_INFORMATION_EX)。
返回值
IoGetBootDiskInformation 返回以下状态值之一:
返回代码 | 描述 |
---|---|
|
例程成功返回了 BootDiskInformation指定的缓冲区中请求的信息。 |
|
Size 的值小于 BOOTDISK_INFORMATION 结构的大小(以字节为单位)。 |
|
驱动程序在系统启动后调用例程。 只有启动和系统驱动程序才能 IoGetBootDiskInformation,然后只能在其 DriverEntry 或 AddDevice 例程中调用。 |
言论
IoGetBootDiskInformation 只能由启动驱动程序调用。 此驱动程序应在 重新初始化 回调例程中调用 IoGetBootDiskInformation,驱动程序通过调用 IoRegisterBootDriverReinitialization 例程来注册该例程。
在 Windows XP 和更高版本的 Windows 上,如果 Size 参数 sizeof(BOOTDISK_INFORMATION_EX) 或更大,则例程将返回 BootDiskInformation 缓冲区中的 BOOTDISK_INFORMATION_EX 结构。 否则,如果 大小 至少 sizeof(BOOTDISK_INFORMATION),则例程将返回 BOOTDISK_INFORMATION 结构。
在 Windows 2000 上,例程仅返回 BOOTDISK_INFORMATION 结构。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 从 Windows 2000 开始可用。 |
目标平台 | 普遍 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |