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

Статья
02/26/2024

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

Синтаксис

PCONFIGURATION_INFORMATION IoGetConfigurationInformation();

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

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)