IoGetConfigurationInformation 函数 (ntifs.h)
IoGetConfigurationInformation 例程返回指向 I/O 管理器的全局配置信息结构的指针,该结构包含物理磁盘、软盘、CD-ROM、磁带、SCSI HBA、串行和并行设备创建的设备对象数的当前值,以便在加载驱动程序时由驱动程序表示它们。
语法
PCONFIGURATION_INFORMATION IoGetConfigurationInformation();
返回值
IoGetConfigurationInformation 返回指向 CONFIGURATION_INFORMATION 结构的指针。
注解
当每个驱动程序创建其设备对象时,某些类型的设备驱动程序可以使用配置信息结构的值来构造具有相应数字后缀的设备对象名称。 请注意,设备对象名称的数字后缀是从零开始的计数,而配置信息结构中维护的计数表示已创建的特定类型的设备对象数。 也就是说,配置信息计数从 1 开始。
调用 IoGetConfigurationInformation 的任何驱动程序在创建表示物理设备的设备对象时,必须递增其在此结构中的设备类型的计数。
系统提供的 SCSI 端口驱动程序提供计算机中存在的 SCSI HBA 计数。 SCSI 类驱动程序可以读取此值,以确定有多少特定于 HBA 的微型端口驱动程序可以使用类驱动程序类型的附加设备控制 SCSI 总线。
配置信息结构还包含一个值,该值指示已加载的驱动程序是否已声明“AT”磁盘 I/O 地址范围之一。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 |
目标平台 | 通用 |
标头 | ntifs.h (包括 Ntddk.h、Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 符合性规则 | HwStorPortProhibitedDDI (storport) 、 IrqlIoPassive5 (wdm) 、 PowerIrpDDis (wdm) |