IDE_ADAPTER_CONTROL回调函数 (irb.h)

  • 项目

调用 AtaAdapterControl 微型端口驱动程序例程，对 HBA 执行即插即用 (PnP) 和电源管理操作。

注意

ATA 端口驱动程序和 ATA 微型端口驱动程序模型将来可能会更改或不可用。 建议改用 Storport 驱动程序 和 Storport 微型端口 驱动程序模型。

语法

IDE_ADAPTER_CONTROL IdeAdapterControl;

BOOLEAN IdeAdapterControl(
  [in]      PVOID ControllerExtension,
  [in]      IDE_CONTROL_ACTION ControlAction,
  [in, out] PVOID Parameters
)
{...}

参数

[in] ControllerExtension

指向控制器扩展的指针。

[in] ControlAction

微型端口驱动程序必须执行下表中定义的五个操作之一。

ControlAction 参数 说明
IdeStart IDE_CONTROLLER_CONFIGURATION 指示适配器正在启动。 微型端口驱动程序应更新 IDE_CONTROLLER_CONFIGURATION 结构中的成员。 如果需要，微型端口驱动程序可以从 IDE_CONTROLLER_CONFIGURATION 结构获取其硬件资源。
IdeStop 无 微型端口驱动程序应停止使用此控制器分配的任何资源。 请注意，端口驱动程序保证适配器公开的所有通道在停止适配器之前停止。
IdePowerUp 无 指示适配器正在打开。 在 IdePowerUp 期间，必须配置未在电源周期中保留的任何内容。
IdePowerDown 无 指示适配器处于关闭状态。
IdeVendorDefined 无 指示微型端口驱动程序应执行供应商定义的控制操作。

[in, out] Parameters

与给定操作关联的参数。

返回值

微型端口驱动程序必须返回 TRUE 才能确认请求的操作已完成。 返回值为 FALSE 表示微型端口驱动程序无法成功完成操作。 某些操作的返回值为 FALSE 可能会导致设备安装失败。

注解

端口驱动程序保证在调用 AtaAdapterControl 例程之前，适配器上没有未完成的 I/O。

要求

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

另请参阅

IDE_CONTROLLER_CONFIGURATION