IoGetConfigurationInformation 函式 (ntifs.h)

IoGetConfigurationInformation 例程會傳回 I/O 管理員全域組態資訊結構的指標,其中包含載入驅動程式時,磁碟驅動器、CD-ROM、磁帶、SCSI HBA、序列和平行裝置的目前值。

Syntax

PCONFIGURATION_INFORMATION IoGetConfigurationInformation();

傳回值

IoGetConfigurationInformation 會傳回 CONFIGURATION_INFORMATION 結構的指標。

備註

當每個驅動程式建立其裝置物件時,特定類型的設備驅動器可以使用組態信息結構的值來建構具有適當數位後綴的裝置物件名稱。 請注意,裝置物件名稱的數位後綴是以零起始的計數,而設定資訊結構中維護的計數則代表已建立特定類型的裝置物件數目。 也就是說,組態資訊計數是以一為基底。

呼叫 IoGetConfigurationInformation 的任何驅動程式,在建立裝置物件來代表實體裝置時,必須遞增此結構中裝置種類的計數。

系統提供的 SCSI 埠驅動程式會提供計算機中存在的 SCSI HBA 計數。 SCSI 類別驅動程式可以讀取此值,以判斷有多少 HBA 特定的迷你埠驅動程式可能會控制具有類別驅動程式類型之連結裝置的 SCSI 總線。

組態信息結構也包含值,指出已載入的驅動程式是否已宣告其中一個 「AT」 磁碟 I/O 位址範圍。

規格需求

需求
最低支援的用戶端 Windows 2000
目標平台 Universal
標頭 ntifs.h (包含 Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) IrqlIoPassive5 (wdm) PowerIrpDDis (wdm)

另請參閱

HalAssignSlotResources

HalGetBusData

HalGetBusDataByOffset

IoAssignResources

IoQueryDeviceDescription

IoReportResourceUsage