Функция IoGetConfigurationInformation (ntddk.h)

  • Статья

Подпрограмма IoGetConfigurationInformation возвращает указатель на глобальную структуру сведений о конфигурации диспетчера ввода-вывода, которая содержит текущие значения для количества физических дисков, гибких дисков, компакт-дисков, ленточных, SCSI HBA, последовательных и параллельных устройств, которые создаются для представления их драйверами при загрузке.

Синтаксис

PCONFIGURATION_INFORMATION IoGetConfigurationInformation();

Возвращаемое значение

IoGetConfigurationInformation возвращает указатель на структуру CONFIGURATION_INFORMATION .

Комментарии

Некоторые типы драйверов устройств могут использовать значения структуры сведений о конфигурации для создания имен объектов устройств с соответствующими суффиксами цифр, когда каждый драйвер создает свои объекты устройства. Обратите внимание, что суффикс цифр для имен объектов устройств является числом отсчитываемых от нуля, а счетчики, сохраняемые в структуре сведений о конфигурации, представляют количество уже созданных объектов устройства определенного типа. То есть количество сведений о конфигурации является единым.

Любой драйвер, вызывающий IoGetConfigurationInformation , должен увеличивать количество устройств своего типа в этой структуре при создании объекта устройства для представления физического устройства.

Предоставляемый системой драйвер порта SCSI предоставляет количество адаптеров SCSI, присутствующих на компьютере. Драйверы класса SCSI могут считывать это значение, чтобы определить, сколько драйверов мини-портов, относящихся к HBA, могут управлять шиной SCSI с подключенным устройством типа драйвера класса.

Структура сведений о конфигурации также содержит значение, указывающее, утверждал ли уже загруженный драйвер любой из диапазонов адресов ввода-вывода диска AT.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть 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