IoGetBootDiskInformation-Funktion (wdm.h)
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 |
|---|---|
|
Die Routine hat die angeforderten Informationen erfolgreich in dem von BootDiskInformation angegebenen Puffer zurückgegeben. |
|
Der Wert von Size ist kleiner als die Größe einer BOOTDISK_INFORMATION-Struktur in Bytes. |
|
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 |