Share via

функция обратного вызова IDE_ADAPTER_CONTROL (irb.h)

  • Статья

Подпрограмма драйвера мини-порта AtaAdapterControl вызывается для выполнения операций Plug and Play (PnP) и управления питанием на адаптере HBA.

Примечание

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

Синтаксис

IDE_ADAPTER_CONTROL IdeAdapterControl;

BOOLEAN IdeAdapterControl(
  [in]      PVOID ControllerExtension,
  [in]      IDE_CONTROL_ACTION ControlAction,
  [in, out] PVOID Parameters
)
{...}

Параметры

[in] ControllerExtension

Указатель на расширение контроллера.

[in] ControlAction

Одно из пяти действий, которые должен выполнить драйвер мини-порта, как определено в следующей таблице.

ControlAction Параметры Описание
IdeStart IDE_CONTROLLER_CONFIGURATION Указывает, что адаптер запускается. Драйвер мини-порта должен обновить элемент в структуре IDE_CONTROLLER_CONFIGURATION . Если это необходимо, драйвер мини-порта может получить свои аппаратные ресурсы из структуры IDE_CONTROLLER_CONFIGURATION .
IdeStop None Драйвер мини-порта должен прекратить использование всех ресурсов, выделенных для этого контроллера. Имейте в виду, что драйвер порта гарантирует, что все каналы, предоставляемые адаптером, будут остановлены перед остановкой адаптера.
IdePowerUp None Указывает, что адаптер включен. Все, что не сохраняется в течение цикла питания, необходимо настроить во время IdePowerUp.
IdePowerDown None Указывает, что адаптер отключен.
IdeVendorDefined None Указывает, что драйвер мини-порта должен выполнять определяемое поставщиком действие управления.

[in, out] Parameters

Параметры, связанные с заданным действием.

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

Драйвер мини-порта должен вернуть значение TRUE , чтобы подтвердить завершение запрошенного действия. Возвращаемое значение FALSE указывает, что драйверу мини-порта не удалось успешно выполнить действие. Возвращаемое значение FALSE для определенных действий может привести к сбою установки устройства.

Комментарии

Драйвер порта гарантирует отсутствие незавершенных операций ввода-вывода на адаптере перед вызовом подпрограммы AtaAdapterControl .

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть irb.h (включая Irb.h)

См. также раздел

IDE_CONTROLLER_CONFIGURATION