TapeClassInitialize 関数 (minitape.h)

  • [アーティクル]

TapeClassInitialize ルーチンは、ミニクラス ドライバーの代わりにドライバーとデバイスの初期化の多くを実行します。 TapeClassInitialize は、テープ I/O 要求のテープ クラス ドライバー エントリ ポイントをミニクラス ドライバーのデータ構造に読み込み、ミニクラス ドライバーがサポートする未要求のテープ デバイスを探して要求し、ミニクラス ドライバーとそのデバイスのオペレーティング システム リソースを割り当てて初期化します。 TapeClassInitialize は、 TapeInitData で提供されるミニクラス ドライバー固有の情報を使用し、ドライバー固有の操作のためにテープ ミニクラス ドライバーに戻ります。

構文

SCSIPORT_API ULONG TapeClassInitialize(
  [in] PVOID              Argument1,
  [in] PVOID              Argument2,
  [in] PTAPE_INIT_DATA_EX TapeInitData
);

パラメーター

[in] Argument1

テープ ミニクラス ドライバーの DriverEntry ルーチンに渡されたドライバー コンテキスト情報へのポインター。 情報の形式はオペレーティング システム固有であり、テープ ミニクラス ドライバーで解釈することはできません。

[in] Argument2

テープ ミニクラス ドライバーの DriverEntry ルーチンに渡された 2 番目のドライバー コンテキスト構造体へのポインター。 情報の形式はオペレーティング システム固有であり、テープ ミニクラス ドライバーで解釈することはできません。

[in] TapeInitData

テープ ミニクラス ドライバーのコマンド処理ルーチンのエントリ ポイントなど、ドライバー固有の情報を含むTAPE_INIT_DATA_EX構造体へのポインター。

戻り値

TapeClassInitialize は、ドライバーの初期化の成功または失敗を示す値を返します。 テープ ミニクラス ドライバーは、 DriverEntry ルーチンからの戻り値として、解釈されていないこの値を渡します。

注釈

テープ ミニクラス ドライバーは、DriverEntry ルーチンから TapeClassInitialize を呼び出し、TapeInitData でドライバー固有の情報を渡します。 TapeClassInitialize は、ミニクラス ドライバーの代わりにドライバーの初期化の大部分を実行し、オペレーティング システム固有の詳細からミニクラス ドライバーを保護します。

TapeClassInitialize は、初期化中に必要なドライバー固有のアクティビティに対してテープ ミニクラス ドライバーを呼び出します。 たとえば、 TapeClassInitialize は、テープ ミニクラス ドライバーの TapeMiniVerifyInquiry ルーチンを呼び出して、ドライバーが特定のテープ デバイスをサポートしているかどうかを判断します。 また、TapeClassInitialize は、ミニクラス ドライバーが要求した場合に、テープ ミニクラス ドライバーの TapeMiniExtensionInit ルーチンを呼び出してミニテープ拡張機能を初期化します。

テープ ミニクラス ドライバーは、スタックにTAPE_INIT_DATA_EX構造体を割り当て、 それを TapeClassZeroMemory でクリアし、適切なすべてのメンバーを入力して、 TapeClassInitialize に渡します。

要件

要件 値
対象プラットフォーム デスクトップ
Header minitape.h (Minitape.h を含む)
Library Tape.lib

こちらもご覧ください

テープ ミニクラス ドライバーの DriverEntry

TAPE_INIT_DATA_EX