Fonction IoGetConfigurationInformation (ntifs.h)

La routine IoGetConfigurationInformation retourne un pointeur vers la structure d’informations de configuration globale du gestionnaire d’E/S, qui contient les valeurs actuelles du nombre de périphériques de disque physique, de disquette, de CD-ROM, de bande, de HBA SCSI, de série et parallèles créés pour les représenter par les pilotes à mesure qu’ils sont chargés.

Syntaxe

PCONFIGURATION_INFORMATION IoGetConfigurationInformation();

Valeur de retour

IoGetConfigurationInformation retourne un pointeur vers une structure CONFIGURATION_INFORMATION .

Remarques

Certains types de pilotes de périphérique peuvent utiliser les valeurs de la structure d’informations de configuration pour construire des noms d’objets de périphérique avec des suffixes de chiffres appropriés lorsque chaque pilote crée ses objets de périphérique. Notez que le suffixe numérique pour les noms d’objets d’appareil est un nombre de base zéro, tandis que les nombres conservés dans la structure d’informations de configuration représentent le nombre d’objets d’appareil d’un type particulier déjà créé. Autrement dit, le nombre d’informations de configuration est basé sur une base unique.

Tout pilote qui appelle IoGetConfigurationInformation doit incrémenter le nombre de son type d’appareil dans cette structure lorsqu’il crée un objet d’appareil pour représenter un appareil physique.

Le pilote de port SCSI fourni par le système fournit le nombre de HBA SCSI présents sur l’ordinateur. Les pilotes de classe SCSI peuvent lire cette valeur pour déterminer le nombre de pilotes miniport spécifiques à HBA qui peuvent contrôler un bus SCSI avec un périphérique attaché du type de pilote de classe.

La structure d’informations de configuration contient également une valeur indiquant si un pilote déjà chargé a revendiqué l’une des plages d’adresses d’E/S du disque « AT ».

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000
Plateforme cible Universal
En-tête ntifs.h (inclure Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

Voir aussi

HalAssignSlotResources

HalGetBusData

HalGetBusDataByOffset

IoAssignResources

IoQueryDeviceDescription

IoReportResourceUsage