Función IoGetConfigurationInformation (ntifs.h)
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 cuántos discos físicos, disquete, CD-ROM, cinta, HBA SCSI, serie y dispositivos paralelos tienen objetos de dispositivo creados para representarlos por controladores a medida que se cargan.
Sintaxis
PCONFIGURATION_INFORMATION IoGetConfigurationInformation();
Valor devuelto
IoGetConfigurationInformation devuelve un puntero a una estructura de CONFIGURATION_INFORMATION.
Observaciones
Algunos tipos de controladores de dispositivo 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ígitos 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 miniport específicos de HBA pueden controlar un bus SCSI con un dispositivo conectado del tipo de 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 | Valor |
---|---|
cliente mínimo admitido | Windows 2000 |
de la plataforma de destino de | Universal |
encabezado de | ntifs.h (include Ntddk.h, Ntifs.h) |
biblioteca de | NtosKrnl.lib |
DLL de | NtosKrnl.exe |
irQL | PASSIVE_LEVEL |
reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |