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 例程必须基于 deviceParameters 参数指向的 IDE_DEVICE_PARAMETERS 结构中指定的信息配置每个设备。 在特殊情况下,微型端口驱动程序可以使用一组不同于 IDE_DEVICE_PARAMETERS中包含的参数来配置设备。 在这种情况下,微型端口驱动程序必须更新 IDE_DEVICE_PARAMETERS 中的信息,以包含它实际用于配置设备的参数值。 在 IdeHwInitialize 例程返回后,端口驱动程序使用微型端口驱动程序提供的参数值更新其缓存信息。

要求

要求
目标平台 桌面
标头 irb.h (包括 Irb.h)

另请参阅

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS