Funzione IoGetBootDiskInformation (wdm.h)

Articolo
07/02/2025

La routine IoGetBootDiskInformation restituisce informazioni che descrivono i dischi di avvio e di sistema.

Sintassi

C++

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

Parametri

[in, out] BootDiskInformation

Puntatore a un buffer allocato dal chiamante usato dalla routine per restituire informazioni sui dischi di avvio e di sistema. La routine riempie il buffer in con un BOOTDISK_INFORMATION o una struttura BOOTDISK_INFORMATION_EX.

[in] Size

Specifica le dimensioni, in byte, del buffer specificato da BootDiskInformation. Deve essere sizeof(BOOTDISK_INFORMATION) o sizeof(BOOTDISK_INFORMATION_EX).

Valore restituito

IoGetBootDiskInformation restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La routine ha restituito correttamente le informazioni richieste nel buffer specificato da BootDiskInformation.
STATUS_INVALID_PARAMETER	Il valore di Size è minore delle dimensioni, in byte, di una struttura BOOTDISK_INFORMATION.
STATUS_TOO_LATE	Il driver ha chiamato la routine dopo l'avvio del sistema. Solo i driver di avvio e di sistema possono chiamare IoGetBootDiskInformatione quindi solo nelle routine DriverEntry o AddDevice.

Osservazioni

IoGetBootDiskInformation può essere chiamato solo da un driver di avvio. Questo driver deve chiamare IoGetBootDiskInformation in un Reinitialize routine di callback registrata dal driver chiamando la routine IoRegisterBootDriverReinitialization.

In Windows XP e versioni successive di Windows, se il parametro Size è sizeof(BOOTDISK_INFORMATION_EX) o superiore, la routine restituisce una struttura BOOTDISK_INFORMATION_EX nel buffer BootDiskInformation. In caso contrario, se size è almeno sizeof(BOOTDISK_INFORMATION), la routine restituisce una struttura BOOTDISK_INFORMATION.

In Windows 2000 la routine restituisce solo la struttura BOOTDISK_INFORMATION.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 2000.
piattaforma di destinazione	Universale
intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	<= APC_LEVEL