AtaAdapterControl ミニポート ドライバー ルーチンは、プラグ アンド プレイ (PnP) と HBA の電源管理操作を実行するために呼び出されます。
手記
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 がないことを保証します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | irb.h (Irb.h を含む) |