IoGetConfigurationInformation 函数 (ntddk.h)

IoGetConfigurationInformation 例程返回指向 I/O 管理器的全局配置信息结构的指针,该结构包含加载驱动程序时,有多少物理磁盘、软盘、CD-ROM、磁带、SCSI HBA、串行和并行设备创建设备对象来表示这些物理磁盘、软盘、CD-ROM、串行和并行设备。

语法

PCONFIGURATION_INFORMATION IoGetConfigurationInformation();

返回值

IoGetConfigurationInformation 返回指向 CONFIGURATION_INFORMATION 结构的指针。

言论

当每个驱动程序创建其设备对象时,某些类型的设备驱动程序可以使用配置信息结构的值来构造具有适当数字后缀的设备对象名称。 请注意,设备对象名称的数字后缀是一个从零开始的计数,而配置信息结构中维护的计数表示已创建的特定类型的设备对象数。 也就是说,配置信息计数基于一个。

调用 IoGetConfigurationInformation 的任何驱动程序 在创建表示物理设备的设备对象时,必须递增其类型设备的计数。

系统提供的 SCSI 端口驱动程序提供计算机中存在的 SCSI HBA 计数。 SCSI 类驱动程序可以读取此值,以确定多少个特定于 HBA 的微型端口驱动程序可以使用类驱动程序类型的附加设备控制 SCSI 总线。

配置信息结构还包含一个值,该值指示已加载的驱动程序是否已声明“AT”磁盘 I/O 地址范围之一。

要求

要求 价值
目标平台 普遍
标头 ntddk.h (包括 Ntddk.h、 Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 符合性规则 HwStorPortProhibitedDIS(storport)IrqlIoPassive5(wdm)PowerIrpDDis(wdm)

另请参阅

HalAssignSlotResources

HalGetBusData

HalGetBusDataByOffset

IoAssignResources

IoQueryDeviceDescription

IoReportResourceUsage