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 (包括 Irb.h)

另请参阅

IDENTIFY_DEVICE_DATA

IDE_DEVICE_PARAMETERS