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

ミニポート ドライバーが次の表で定義されているように実行する必要がある 5 つのアクションのいずれか。

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 がないことを保証します。

要件

要件 値
対象プラットフォーム デスクトップ
Header irb.h (Irb.h を含む)

こちらもご覧ください

IDE_CONTROLLER_CONFIGURATION