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

Статья
08/07/2023

Подпрограмма драйвера минипорта AtaChannelInitRoutine инициализирует интерфейс канала драйвера минипорта.

Примечание

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

Синтаксис

IDE_CHANNEL_INIT IdeChannelInit;

BOOLEAN IdeChannelInit(
  PVOID ChannelExtension,
  PIDE_CHANNEL_INTERFACE ChannelInterface,
  PVOID InitContext
)
{...}

Параметры

ChannelExtension

[in] Указатель на расширение канала драйвера мини-порта.

ChannelInterface

[вход, выход] Указатель на структуру IDE_CHANNEL_INTERFACE , содержащую сведения об интерфейсе для указанного канала.

InitContext

[вход, выход] Указатель на расширение контроллера.

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

AtaChannelInitRoutine возвращает значение TRUE, если инициализация выполнена успешно. Если инициализация завершилась сбоем, возвращается значение FALSE.

Предоставленный поставщиком драйвер miniport, поддерживающий интерфейс канала, должен реализовывать подпрограмму AtaChannelInitRoutine для инициализации каналов контроллера. В частности, подпрограмма AtaChannelInitRoutine должна завершить инициализацию структуры IDE_CHANNEL_INTERFACE . В следующей последовательности описывается взаимодействие драйвера мини-порта и драйвера порта для инициализации канала.

В своей подпрограмме DriverEntry драйвер мини-порта вызывает подпрограмму библиотеки AtaPortInitializeEx драйвера порта, чтобы запустить инициализацию контроллера и драйвера минипорта.
Если драйвер мини-порта поддерживает интерфейс канала, подпрограмма DriverEntry должна инициализировать элемент AtaChannelInitRoutineIDE_CONTROLLER_INTERFACE , чтобы указать на подпрограмму AtaChannelInitRoutine драйвера мини-порта.
Драйвер порта вызывает подпрограмму AtaAdapterControl с помощью действия управления IdeStart. AtaChannelInitRoutine вызывается один раз для каждого объекта NumberOfChannels, указанного в структуре ControllerConfiguration, возвращаемой подпрограммой AtaAdapterControl , когда AtaAdapterControl обрабатывает действие IdeStart .