AtaPortInitializeEx 関数 (irb.h)

[アーティクル]
08/07/2023

AtaPortInitializeEx ATA ポートドライバーライブラリルーチンは、ポートとミニポートドライバーを初期化します。

メモ ATA ポートドライバーと ATA ミニポートドライバーモデルは、今後変更または使用できない可能性があります。代わりに、 Storport ドライバーと Storport ミニポートドライバーモデルを使用することをお勧めします。

構文

ULONG AtaPortInitializeEx(
  [in] PVOID                     DriverObject,
  [in] PVOID                     RegistryPath,
  [in] PIDE_CONTROLLER_INTERFACE ControllerInterface
);

パラメーター

[in] DriverObject

ミニポートドライバーオブジェクトへのポインター。

[in] RegistryPath

ミニポートドライバーの構成情報が格納されているレジストリ内の場所を示す Unicode 文字列が含まれています。

[in] ControllerInterface

AtaAdapterControl、AtaChannelInitRoutine、AtaControllerChannelEnabled、および AtaControllerTransferModeSelect ルーチンのエントリポイントを格納します。

戻り値

操作が成功した場合、AtaPortInitializeEx はSTATUS_SUCCESSを返します。それ以外の場合は、エラーコードを返します。

注釈

AtaPortInitializeEx ルーチンは、ポートとミニポートドライバーによって使用されるキーデータ構造を初期化します。また、コントローラーのチャネルの初期化も開始します。次のシーケンスでは、このルーチンによって実行されるプリンシパルアクションについて説明します。

DriverEntry ルーチンでは、ミニポートドライバーはポートドライバーの AtaPortInitializeEx ライブラリルーチンを呼び出し、次のキーパラメーターを渡します。
- ControllerInterface: AtaAdapterControl、 AtaChannelInitRoutine、 AtaControllerChannelEnabled、および AtaControllerTransferModeSelect ルーチンのエントリポイントが含まれます。
AtaPortInitializeEx ルーチンは、ポートとミニポートドライバーによって使用されるキーデータ構造を初期化し、次のアクションを実行します。
1. ミニポートドライバーのディスパッチテーブルを初期化します。
2. ドライバーオブジェクトの拡張機能を割り当てます。
3. ControllerInterface をドライバー拡張機能にコピーします。
4. AtaPortInitializeEx がポートドライバーの初期化を完了すると、ミニポートドライバーの DriverEntry ルーチンに戻ります。
アダプターデバイスの起動中に、ミニポートドライバールーチン AtaAdapterControl は、コントロールアクション IdeStart を持つポートドライバーによって呼び出されます。
ATA ポートドライバーがチャネルデバイスの開始要求を処理している場合、ミニポートドライバールーチン AtaControllerChannelEnabled がコントローラー上の各チャネルに対して呼び出され、有効になっているかどうかを判断します。
AtaControllerChannelEnabled ルーチンが有効になっているチャネルを決定した後、ATA ポートドライバーはこのチャネルに対して AtaChannelInitRoutine を呼び出します。