Fonction IoGetConfigurationInformation (ntddk.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 |
|---|---|
| Plateforme cible | Universal |
| En-tête | ntddk.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) |