共用方式為

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

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

言論

IoGetBootDiskInformation 只能由開機驅動程式呼叫。 此驅動程式應該呼叫 IoGetBootDiskInformation，Reinitialize 回呼例程中，驅動程式藉由呼叫 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 開始提供。
目標平臺 普遍
標頭 wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h）
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

BOOTDISK_INFORMATION

BOOTDISK_INFORMATION_EX

IoRegisterBootDriverReinitialization

重新初始化