IoGetBootDiskInformation-Funktion (wdm.h)

Artikel
02/07/2025

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

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, den die Routine verwendet, 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 durch BootDiskInformation-angegebenen Puffers in Bytes an. Sollte entweder Größe(BOOTDISK_INFORMATION) oder Größe(BOOTDISK_INFORMATION_EX) sein.

Rückgabewert

IoGetBootDiskInformation gibt einen der folgenden Statuswerte zurück:

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

Bemerkungen

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

Wenn der Parameter Size unter Windows XP und höher Größe(BOOTDISK_INFORMATION_EX) oder höher ist, gibt die Routine eine BOOTDISK_INFORMATION_EX Struktur im BootDiskInformation Puffer zurück. Andernfalls gibt die Routine eine BOOTDISK_INFORMATION Struktur zurück, wenn Größe mindestens Größe(BOOTDISK_INFORMATION) aufweist.

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Ab Windows 2000 verfügbar.
Zielplattform-	Universal
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL

Siehe auch

BOOTDISK_INFORMATION

BOOTDISK_INFORMATION_EX

IoRegisterBootDriverReinitialization

neu initialisieren

Freigeben über