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) |