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 disques physiques, de floppy, de CD-ROM, de bande, de HBA SCSI, de série et de périphériques parallèles, créés pour les représenter par les pilotes au fur et à 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 d’appareil avec des suffixes de chiffres appropriés lorsque chaque pilote crée ses objets d’appareil. Notez que le suffixe de chiffre pour les noms d’objets d’appareil est un nombre de base zéro, tandis que les nombres conservés dans la structure des informations de configuration représentent le nombre d’objets d’appareil d’un type particulier déjà créé. Autrement dit, les informations de configuration sont basées sur un seul.
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 d’adaptateurs 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 susceptibles de contrôler un bus SCSI avec un périphérique attaché du type du pilote de classe.
La structure des 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 de disque « AT ».
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include 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) |