IDE_ADAPTER_CONTROL回呼函式 （irb.h）
AtaAdapterControl 迷你埠驅動程式例程會呼叫，以在 HBA 上執行隨插即用 （PnP） 和電源管理作業。
注意
ATA 埠驅動程式和 ATA 迷你埠驅動程式模型未來可能會改變或無法使用。 相反地，我們建議使用 Storport 驅動程式 和 Storport miniport 驅動程式模型。
語法
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 可能會導致裝置安裝失敗。
言論
埠驅動程式會先保證適配卡上沒有未完成的 I/O，再叫用 AtaAdapterControl 例程。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 桌面 |
| 標頭 | irb.h （包括 Irb.h） |