IoGetConfigurationInformation 函式 (ntifs.h)
IoGetConfigurationInformation 例程會傳回 I/O 管理員全域設定資訊結構的指標,其中包含載入驅動程式時,有多少個實體磁碟、軟盤、CD-ROM、磁帶、SCSI HBA、序列和平行裝置的裝置物件會建立裝置對象來代表它們。
語法
PCONFIGURATION_INFORMATION IoGetConfigurationInformation();
傳回值
IoGetConfigurationInformation 會傳回 CONFIGURATION_INFORMATION 結構的指標。
言論
當每個驅動程式建立裝置物件物件時,某些類型的設備驅動器可以使用組態信息結構的值,以適當的數位後綴來建構裝置物件名稱。 請注意,裝置物件名稱的數位後綴是以零起始的計數,而組態信息結構中維護的計數則代表已建立特定類型的裝置物件數目。 也就是說,組態資訊計數是以單一為基礎。
呼叫ioGetConfigurationInformation 呼叫 的任何驅動程式,都必須在建立裝置物件來代表實體裝置時,遞增其裝置類型計數。
系統提供的 SCSI 埠驅動程式會提供計算機中存在的 SCSI HBA 計數。 SCSI 類別驅動程式可以讀取此值,以判斷有多少 HBA 特定迷你埠驅動程式可能會控制具有類別驅動程式類型之連結裝置的 SCSI 總線。
組態信息結構也包含值,指出已經載入的驅動程式是否已宣告其中一個 「AT」 磁碟 I/O 位址範圍。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 |
目標平臺 | 普遍 |
標頭 | ntifs.h (include Ntddk.h, Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport)、IrqlIoPassive5(wdm)、PowerIrpDDis(wdm) |