Función IoGetConfigurationInformation (ntddk.h)

  • Artículo

La rutina IoGetConfigurationInformation devuelve un puntero a la estructura de información de configuración global del administrador de E/S, que contiene los valores actuales para el número de discos físicos, disquete, CD-ROM, cinta, HBA SCSI, serie y dispositivos paralelos que tienen objetos de dispositivo creados para representarlos por los controladores a medida que se cargan.

Sintaxis

PCONFIGURATION_INFORMATION IoGetConfigurationInformation();

Valor devuelto

IoGetConfigurationInformation devuelve un puntero a una estructura CONFIGURATION_INFORMATION .

Comentarios

Ciertos tipos de controladores de dispositivos pueden usar los valores de la estructura de información de configuración para construir nombres de objeto de dispositivo con sufijos de dígito adecuados cuando cada controlador crea sus objetos de dispositivo. Tenga en cuenta que el sufijo de dígito para los nombres de objeto de dispositivo es un recuento de base cero, mientras que los recuentos mantenidos en la estructura de información de configuración representan el número de objetos de dispositivo de un tipo determinado ya creado. Es decir, los recuentos de información de configuración se basan en uno.

Cualquier controlador que llame a IoGetConfigurationInformation debe incrementar el recuento de su tipo de dispositivo en esta estructura cuando crea un objeto de dispositivo para representar un dispositivo físico.

El controlador de puerto SCSI proporcionado por el sistema proporciona el recuento de HBA SCSI presentes en el equipo. Los controladores de clase SCSI pueden leer este valor para determinar cuántos controladores de minipuerto específicos de HBA pueden controlar un bus SCSI con un dispositivo conectado del tipo del controlador de clase.

La estructura de información de configuración también contiene un valor que indica si un controlador ya cargado ha reclamado cualquiera de los intervalos de direcciones de E/S de disco "AT".

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado ntddk.h (include Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

Consulte también

HalAssignSlotResources

HalGetBusData

HalGetBusDataByOffset

IoAssignResources

IoQueryDeviceDescription

IoReportResourceUsage