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

Статья
02/07/2025

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	Никакой	Драйвер минипорта должен остановить использование всех ресурсов, выделенных для этого контроллера. Помните, что драйвер порта гарантирует, что все каналы, предоставляемые адаптером, остановлены перед остановкой адаптера.
IdePowerUp	Никакой	Указывает, что адаптер включен. Все, что не сохраняется в цикле питания, должно быть настроено во время IdePowerUp.
IdePowerDown	Никакой	Указывает, что адаптер отключен.
IdeVendorDefined	Никакой	Указывает, что драйвер минипорта должен выполнять определенное поставщиком действие управления.

[in, out] Parameters

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

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

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

Замечания

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	irb.h (include Irb.h)

См. также

IDE_CONTROLLER_CONFIGURATION

Поделиться через