IoGetBootDiskInformation-Funktion (wdm.h)

  • Artikel

Die IoGetBootDiskInformation-Routine gibt Informationen zurück, die die Start- und Systemdatenträger beschreiben.

Syntax

NTSTATUS IoGetBootDiskInformation(
  [in, out] PBOOTDISK_INFORMATION BootDiskInformation,
  [in]      ULONG                 Size
);

Parameter

[in, out] BootDiskInformation

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der von der Routine verwendet wird, um Informationen über die Start- und Systemdatenträger zurückzugeben. Die Routine füllt diesen Puffer entweder mit einer BOOTDISK_INFORMATION oder einer BOOTDISK_INFORMATION_EX-Struktur aus.

[in] Size

Gibt die Größe des puffers in Bytes an, der von BootDiskInformation angegeben wird. Sollte entweder sizeof(BOOTDISK_INFORMATION) oder sizeof(BOOTDISK_INFORMATION_EX) sein.

Rückgabewert

IoGetBootDiskInformation gibt einen der folgenden status Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
 Die Routine hat die angeforderten Informationen erfolgreich in dem von BootDiskInformation angegebenen Puffer zurückgegeben.
STATUS_INVALID_PARAMETER
 Der Wert von Size ist kleiner als die Größe einer BOOTDISK_INFORMATION-Struktur in Bytes.
STATUS_TOO_LATE
 Der Treiber hat die Routine aufgerufen, nachdem das System bereits gestartet wurde. Nur Start- und Systemtreiber können IoGetBootDiskInformation und dann nur in ihren DriverEntry - oder AddDevice-Routinen aufrufen.

Hinweise

IoGetBootDiskInformation kann nur von einem Starttreiber aufgerufen werden. Dieser Treiber sollte IoGetBootDiskInformation in einer Rückrufroutine aufrufen , die der Treiber durch Aufrufen der IoRegisterBootDriverReinitialization-Routine registriert.

Wenn der Size-Parameter unter Windows XP und höheren Versionen von Windows sizeof(BOOTDISK_INFORMATION_EX) oder größer ist, gibt die Routine eine BOOTDISK_INFORMATION_EX Struktur im Puffer BootDiskInformation zurück. Andernfalls gibt die Routine eine BOOTDISK_INFORMATION Struktur zurück, wenn Size mindestens sizeof(BOOTDISK_INFORMATION ist).

Unter Windows 2000 gibt die Routine nur die BOOTDISK_INFORMATION-Struktur zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Weitere Informationen

BOOTDISK_INFORMATION

BOOTDISK_INFORMATION_EX

IoRegisterBootDriverReinitialisierung

Initialisieren