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)

Weitere Informationen

HalAssignSlotResources

HalGetBusData

HalGetBusDataByOffset

IoAssignResources

IoQueryDeviceDescription

IoReportResourceUsage