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