IoGetConfigurationInformation-Funktion (ntifs.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 für die Darstellung durch Treiber erstellt werden, während sie geladen werden.
Syntax
PCONFIGURATION_INFORMATION IoGetConfigurationInformation();
Rückgabewert
IoGetConfigurationInformation gibt einen Zeiger auf eine CONFIGURATION_INFORMATION Struktur zurück.
Bemerkungen
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 Geräteobjekte eines bestimmten Typs darstellen, die bereits erstellt wurden. Das heißt, die Anzahl der Konfigurationsinformationen ist einsbasiert.
Jeder Treiber, der IoGetConfigurationInformation aufruft, muss die Anzahl der Geräte in dieser Struktur erhöhen, wenn ein Geräteobjekt erstellt wird, das ein physisches Gerät darstellt.
Der vom System bereitgestellte SCSI-Porttreiber liefert die Anzahl der auf dem Computer vorhandenen SCSI-HBAs. 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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 |
| Zielplattform- | Universal |
| Header- | ntifs.h (enthalten Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |