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

Подпрограмма драйвера минипорта IdeHwInitialize настраивает указанное устройство.

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

 

Синтаксис

IDE_HW_INITIALIZE IdeHwInitialize;

BOOLEAN IdeHwInitialize(
  [in]      PVOID ChannelExtension,
  [in, out] PIDE_DEVICE_PARAMETERS DeviceParameters,
  [in]      PIDENTIFY_DEVICE_DATA IdentifyData
)
{...}

Параметры

[in] ChannelExtension

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

[in, out] DeviceParameters

Указатель на структуру типа IDE_DEVICE_PARAMETERS, которая определяет устройство для настройки и параметры устройства, с помощью которых необходимо настроить устройство.

[in] IdentifyData

Указатель на структуру типа IDENTIFY_DEVICE_DATA, содержащую данные идентификации, возвращаемые устройством.

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

IdeHwInitialize возвращает true, если операция выполнена успешно. Он возвращает FALSE, если операция завершается ошибкой.

Замечания

После перечисления устройств в канале драйвер минипорта вызывает процедуру IdeHwInitialize по одному разу для каждого перечисленного устройства. ПодпрограммаIdeHwInitialize должна настроить каждое устройство на основе сведений, указанных в структуре IDE_DEVICE_PARAMETERS, на которое указывает параметр DeviceParameters. В исключительных случаях минипорт-драйвер может настроить устройство с помощью набора параметров, которые отличаются от параметров, содержащихся в IDE_DEVICE_PARAMETERS. В таких случаях мини-драйвер должен обновить сведения в IDE_DEVICE_PARAMETERS, чтобы он содержал значение параметра, которое фактически использовалось для настройки устройства. После возврата подпрограммыIdeHwInitialize драйвер порта обновляет кэшированные сведения со значениями параметров, предоставляемыми драйвером мини-порта.

Требования

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

См. также

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS