IoGetConfigurationInformation-Funktion (ntddk.h)
Die IoGetConfigurationInformation-Routine gibt einen Zeiger auf die globale Konfigurationsinformationsstruktur des E/A-Managers zurück, die die aktuellen Werte für die Anzahl der physischen Datenträger, Disketten, CD-ROM, Band-, SCSI-HBA-, seriellen und parallelen Geräte enthält, die Geräteobjekte erstellt haben, um sie nach Treibern darzustellen, während sie geladen werden.
Syntax
PCONFIGURATION_INFORMATION IoGetConfigurationInformation();
Rückgabewert
IoGetConfigurationInformation gibt einen Zeiger auf eine CONFIGURATION_INFORMATION-Struktur zurück.
Hinweise
Bestimmte Gerätetreibertypen können die Werte der Konfigurationsinformationsstruktur verwenden, um Geräteobjektnamen mit entsprechenden Ziffernsuffixen zu erstellen, wenn jeder Treiber seine Geräteobjekte erstellt. Beachten Sie, dass das Ziffernsuffix für Geräteobjektnamen eine nullbasierte Anzahl ist, während die in der Konfigurationsinformationsstruktur verwalteten Zählungen die Anzahl der bereits erstellten Geräteobjekte eines bestimmten Typs darstellen. Das heißt, die Anzahl der Konfigurationsinformationen ist einsbasiert.
Jeder Treiber, der IoGetConfigurationInformation aufruft, muss die Anzahl für seinen Gerätetyp in dieser Struktur erhöhen, wenn er ein Geräteobjekt erstellt, das ein physisches Gerät darstellt.
Der vom System bereitgestellte SCSI-Porttreiber stellt die Anzahl der auf dem Computer vorhandenen SCSI-HBAs bereit. SCSI-Klassentreiber können diesen Wert lesen, um zu bestimmen, wie viele HBA-spezifische Miniporttreiber einen SCSI-Bus mit einem angeschlossenen Gerät des Klassentreibertyps steuern können.
Die Konfigurationsinformationsstruktur enthält auch einen Wert, der angibt, ob ein bereits geladener Treiber einen der E/A-Adressbereiche des "AT"-Datenträgers beansprucht hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ntddk.h (include Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |