通过

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