Função IoGetConfigurationInformation (ntifs.h)
A rotina de IoGetConfigurationInformation retorna um ponteiro para a estrutura de informações de configuração global do gerenciador de E/S, que contém os valores atuais para quantos dispositivos físicos, disquete, CD-ROM, fita, SCSI HBA, serial e paralelo têm objetos de dispositivo criados para representá-los pelos drivers à medida que são carregados.
Sintaxe
PCONFIGURATION_INFORMATION IoGetConfigurationInformation();
Valor de retorno
IoGetConfigurationInformation retorna um ponteiro para uma estrutura de CONFIGURATION_INFORMATION.
Observações
Determinados tipos de drivers de dispositivo podem usar os valores da estrutura de informações de configuração para construir nomes de objetos de dispositivo com sufixos de dígito apropriados quando cada driver cria seus objetos de dispositivo. Observe que o sufixo de dígito para nomes de objeto de dispositivo é uma contagem baseada em zero, enquanto as contagens mantidas na estrutura de informações de configuração representam o número de objetos de dispositivo de um tipo específico já criado. Ou seja, as contagens de informações de configuração são baseadas em um.
Qualquer driver que chame IoGetConfigurationInformation deve incrementar a contagem de seu tipo de dispositivo nessa estrutura ao criar um objeto de dispositivo para representar um dispositivo físico.
O driver de porta SCSI fornecido pelo sistema fornece a contagem de HBAs SCSI presentes no computador. Os drivers de classe SCSI podem ler esse valor para determinar quantos drivers de miniporto específicos do HBA podem controlar um barramento SCSI com um dispositivo anexado do tipo do driver de classe.
A estrutura de informações de configuração também contém um valor que indica se um driver já carregado reivindicou um dos intervalos de endereços de E/S de disco "AT".
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 |
| da Plataforma de Destino | Universal |
| cabeçalho | ntifs.h (inclua Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |