Função IoGetConfigurationInformation (ntifs.h)

  • Artigo

A rotina IoGetConfigurationInformation retorna um ponteiro para a estrutura de informações de configuração global do gerente de E/S, que contém os valores atuais de quantos discos físicos, disquetes, CD-ROM, fita, SCSI HBA, serial e dispositivos paralelos têm objetos de dispositivo criados para representá-los por drivers à medida que são carregados.

Sintaxe

PCONFIGURATION_INFORMATION IoGetConfigurationInformation();

Retornar valor

IoGetConfigurationInformation retorna um ponteiro para uma estrutura de CONFIGURATION_INFORMATION .

Comentários

Determinados tipos de drivers de dispositivo podem usar os valores da estrutura de informações de configuração para construir nomes de objeto de dispositivo com sufixos de dígito apropriados quando cada driver cria seus objetos de dispositivo. Observe que o sufixo de dígitos 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 para seu tipo de dispositivo nessa estrutura quando ele cria 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
Cliente mínimo com suporte Windows 2000
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

Confira também

HalAssignSlotResources

HalGetBusData

HalGetBusDataByOffset

IoAssignResources

IoQueryDeviceDescription

IoReportResourceUsage