Funzione IoGetBootDiskInformation (wdm.h)

Articolo
02/27/2024

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

Sintassi

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 questo buffer in con una 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 che il sistema è già stato avviato. Solo i driver di avvio e di sistema possono chiamare IoGetBootDiskInformation e quindi solo nelle routine DriverEntry o AddDevice .

Commenti

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

In Windows XP e versioni successive di Windows, se il parametro Size è sizeof(BOOTDISK_INFORMATION_EX) o maggiore, 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 .

Requisiti

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

Vedi anche

BOOTDISK_INFORMATION

BOOTDISK_INFORMATION_EX

IoRegisterBootDriverReinitialization

Reinizializzare

Condividi tramite