структура IDE_CHANNEL_CONFIGURATION (irb.h)

Структура IDE_CHANNEL_CONFIGURATION содержит сведения о конфигурации указанного канала.

Примечание

В будущем модели драйвера портов ATA и драйвера мини-порта ATA могут быть изменены или недоступны. Вместо этого рекомендуется использовать модели драйверов Storport и драйверов для мини-портов Storport .

Синтаксис

typedef struct _IDE_CHANNEL_CONFIGURATION {
  USHORT                              Version;
  UCHAR                               ChannelNumber;
  SUPPORTED_ADVANCES                  SupportedAdvances;
  IDE_OPERATION_MODE                  ChannelMode;
  PIDE_MINIPORT_RESOURCES             ChannelResources;
  UCHAR                               NumberOfOverlappedRequests;
  UCHAR                               MaxTargetId;
  BOOLEAN                             SyncWithIsr;
  BOOLEAN                             SupportsWmi;
  PIDE_ADVANCED_CHANNEL_CONFIGURATION AdvancedChannelConfiguration;
} IDE_CHANNEL_CONFIGURATION, *PIDE_CHANNEL_CONFIGURATION;

Члены

Version

Драйвер порта задает для этого элемента значение sizeof(IDE_CHANNEL_CONFIGURATION). Драйвер мини-порта должен убедиться, что версия больше или равна той, которую он использует.

ChannelNumber

Драйвер порта задает для этого поля номер, назначенный для этого канала. Для контроллеров, не относящихся к собственному режиму, основной канал всегда назначается 0, а дополнительный — 1.

SupportedAdvances

Защищены; не использовать.

ChannelMode

Драйвер порта задает это поле, чтобы сообщить минипорту ATA, в каком режиме он работает. Существует три возможных режима:

Режим Описание
IdeModeNormal Это стандартный полный режим возможностей, в котором минипорт ATA может работать в обычном режиме.
IdeModeDump Это ограниченный режим без памяти, в который работает мини-порт ATA во время гибернации или аварийного завершения. Процедуры обратного вызова и процедуры доступа к реестру нельзя использовать в этом режиме.
IdeModeRemovableBay Как и в случае с IdeModeNormal, это означает, что мини-порт ATA должен выполнить дополнительные действия, чтобы включить перечисление устройств, которые могли быть только что перенесены на шину Parallel ATA.

ChannelResources

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

NumberOfOverlappedRequests

Драйвер мини-порта должен задать в этом поле количество запросов, которые канал может обрабатывать за раз. По умолчанию драйвер порта устанавливает значение 1.

MaxTargetId

Мини-порт должен задать для этого члена максимальный идентификатор целевого объекта, поддерживаемый в этом канале. Как правило, это на 1 меньше, чем максимальное количество устройств, поддерживаемых в канале. По умолчанию драйвер порта устанавливает значение 1, чтобы указать, что в канале поддерживаются 2 устройства.

SyncWithIsr

Указывает на поддержку несинхронизированной обработки ввода-вывода в драйвере мини-порта. Драйвер мини-порта должен задать для этого члена значение TRUE.

SupportsWmi

Указывает на поддержку WMI. Драйвер мини-порта должен задать для этого члена значение TRUE.

AdvancedChannelConfiguration

Зарезервировано для использования системой; не использовать.

Требования

Требование Значение
Заголовок irb.h (включая Irb.h)