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 會傳回下列其中一個狀態值：

傳回碼 Description
STATUS_SUCCESS
 例程已成功傳回 BootDiskInformation 所指定的緩衝區中所要求的資訊。
STATUS_INVALID_PARAMETER
 Size 的值小於BOOTDISK_INFORMATION結構的大小，以位元組為單位。
STATUS_TOO_LATE
 驅動程式在系統開機之後呼叫例程。 只有開機和系統驅動程式可以呼叫 IoGetBootDiskInformation，然後只能在 其 DriverEntry 或 AddDevice 例程中呼叫。

備註

IoGetBootDiskInformation 只能由開機驅動程式呼叫。 此驅動程式應該在重新初始化回呼例程中呼叫IoGetBootDiskInformation，驅動程式藉由呼叫IoRegisterBootDriverReinitialization 例程來註冊。

在 Windows XP 和更新版本的 Windows 上，如果 Size 參數的大小為 sizeof (BOOTDISK_INFORMATION_EX) 或更大，則例程會在 BootDiskInformation 緩衝區中傳回BOOTDISK_INFORMATION_EX結構。 否則，如果 Size 至少為 sizeof (BOOTDISK_INFORMATION) ，則例程會傳回 BOOTDISK_INFORMATION 結構。

在 Windows 2000 上，例程只會傳回 BOOTDISK_INFORMATION 結構。

規格需求

需求 值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

BOOTDISK_INFORMATION

BOOTDISK_INFORMATION_EX

IoRegisterBootDriverReinitialization

重新初始化