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

функция обратного вызова 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

Указатель на расширение устройства miniport driver per channel.

[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 (включая Irb.h)

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

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS