Fonction IoGetBootDiskInformation (wdm.h)

Article
02/07/2025

La routine IoGetBootDiskInformation retourne des informations décrivant les disques de démarrage et système.

Syntaxe

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

Paramètres

[in, out] BootDiskInformation

Pointeur vers une mémoire tampon allouée par l’appelant que la routine utilise pour retourner des informations sur le démarrage et les disques système. La routine remplit cette mémoire tampon avec une structure BOOTDISK_INFORMATION ou BOOTDISK_INFORMATION_EX.

[in] Size

Spécifie la taille, en octets, de la mémoire tampon spécifiée par BootDiskInformation. Doit être taille de(BOOTDISK_INFORMATION) ou taille de(BOOTDISK_INFORMATION_EX).

Valeur de retour

IoGetBootDiskInformation retourne l’une des valeurs d’état suivantes :

Retourner le code	Description
STATUS_SUCCESS	La routine a correctement retourné les informations demandées dans la mémoire tampon spécifiée par BootDiskInformation.
STATUS_INVALID_PARAMETER	La valeur de Size est inférieure à la taille, en octets, d’une structure BOOTDISK_INFORMATION.
STATUS_TOO_LATE	Le pilote a appelé la routine après le démarrage du système. Seuls les pilotes de démarrage et système peuvent appeler IoGetBootDiskInformation, puis uniquement dans leur DriverEntry ou routines AddDevice.

Remarques

IoGetBootDiskInformation ne peut être appelé que par un pilote de démarrage. Ce pilote doit appeler IoGetBootDiskInformation dans une routine de rappel Reinitialize que le pilote inscrit en appelant la routine IoRegisterBootDriverReinitialization.

Sur Windows XP et les versions ultérieures de Windows, si le paramètre Size est taille de(BOOTDISK_INFORMATION_EX) ou supérieure, la routine retourne une structure BOOTDISK_INFORMATION_EX dans la mémoire tampon BootDiskInformation. Sinon, si taille est au moins taille de(BOOTDISK_INFORMATION), la routine retourne une structure BOOTDISK_INFORMATION.

Sur Windows 2000, la routine retourne uniquement la structure BOOTDISK_INFORMATION.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 2000.
plateforme cible	Universel
d’en-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Voir aussi

BOOTDISK_INFORMATION

BOOTDISK_INFORMATION_EX

IoRegisterBootDriverReinitialization

réinitialiser

Partager via