TAPE_INIT_DATA_EX構造体 (minitape.h)

[アーティクル]
02/07/2025

TAPE_INIT_DATA_EXは、Windows 2000 テープミニクラスドライバーに固有の値とルーチンを定義します。テープミニクラス DriverEntry ルーチンは、この情報をテープクラスドライバーに渡して、ミニクラスドライバーの初期化を完了します。

構文

typedef struct _TAPE_INIT_DATA_EX {
  ULONG                        InitDataSize;
  TAPE_VERIFY_INQUIRY_ROUTINE  VerifyInquiry;
  BOOLEAN                      QueryModeCapabilitiesPage;
  ULONG                        MinitapeExtensionSize;
  TAPE_EXTENSION_INIT_ROUTINE  ExtensionInit;
  ULONG                        DefaultTimeOutValue;
  TAPE_ERROR_ROUTINE           TapeError;
  ULONG                        CommandExtensionSize;
  TAPE_PROCESS_COMMAND_ROUTINE CreatePartition;
  TAPE_PROCESS_COMMAND_ROUTINE Erase;
  TAPE_PROCESS_COMMAND_ROUTINE GetDriveParameters;
  TAPE_PROCESS_COMMAND_ROUTINE GetMediaParameters;
  TAPE_PROCESS_COMMAND_ROUTINE GetPosition;
  TAPE_PROCESS_COMMAND_ROUTINE GetStatus;
  TAPE_PROCESS_COMMAND_ROUTINE Prepare;
  TAPE_PROCESS_COMMAND_ROUTINE SetDriveParameters;
  TAPE_PROCESS_COMMAND_ROUTINE SetMediaParameters;
  TAPE_PROCESS_COMMAND_ROUTINE SetPosition;
  TAPE_PROCESS_COMMAND_ROUTINE WriteMarks;
  TAPE_PROCESS_COMMAND_ROUTINE PreProcessReadWrite;
  TAPE_PROCESS_COMMAND_ROUTINE TapeGetMediaTypes;
  ULONG                        MediaTypesSupported;
  TAPE_PROCESS_COMMAND_ROUTINE TapeWMIOperations;
  ULONG                        Reserved[2];
} TAPE_INIT_DATA_EX, *PTAPE_INIT_DATA_EX;

メンバーズ

InitDataSize

この構造体のサイズ (バイト単位)。

VerifyInquiry

テープミニクラスドライバーの TapeMiniVerifyInquiry ルーチンのエントリポイントを指定します。このルーチンは、ドライバーが特定のデバイスをサポートしているかどうかを判断します。このルーチンは必須です。

QueryModeCapabilitiesPage

TRUE テープミニクラスドライバーの TapeMiniVerifyInquiry にモード機能ページを渡し、TapeMiniExtensionInitルーチンをするときに、テープクラスドライバーを指示します。

MinitapeExtensionSize

ドライバー固有のコンテキスト領域のサイズをバイト単位で指定します。このメンバーが 0 以外の場合、ExtensionInit は NULL できません。この値は省略可能であり、使用しない場合は 0 に設定する必要があります。

ExtensionInit

テープミニクラスドライバーの TapeMiniExtensionInit ルーチンへのポインター。省略可能なミニテープ拡張機能がある場合は初期化します。 MiniTapeExtensionSize 0 の場合は、ExtensionInit NULL する必要があります。

DefaultTimeOutValue

テープクラスドライバーが SRB 要求をキャンセルするまで待機する秒数を指定します。この値が 0 の場合、テープクラスドライバーは適切な既定値を設定します。テープクラスドライバーは常に、読み取りと書き込みの要求に既定のタイムアウト値を使用します。 TAPE_INIT_DATA_EX構造体に含まれるルーチンは、SRB で TimeOutValue 設定することで、デバイス制御要求の既定のタイムアウト値をオーバーライドできます。

TapeError

テープミニクラスドライバーの TapeMiniTapeError ルーチンへのポインター。テープクラスドライバーのエラー処理アクティビティを拡張します。このルーチンは省略可能です。使用しない場合は、TapeError を NULL 設定する必要があります。

CommandExtensionSize

各テープ・コマンドの開始前に割り振られるコマンド拡張のサイズをバイト単位で指定します。テープミニクラスドライバーは、テープコマンドの処理中に、コマンド拡張機能を使用してコンテキストを格納します。そのサイズと内部構造は、テープ・ミニクラス・ドライバーによって定義されます。コマンド拡張機能は省略可能です。使用しない場合は、CommandExtensionSize を 0 に設定する必要があります。

CreatePartition

テープミニクラスドライバーの TapeMiniCreatePartition ルーチンへのポインター。テープ上にパーティションが作成されます。このルーチンは必須です。

Erase

テープミニクラスドライバーの TapeMiniErase ルーチンへのポインター。テープが消去されます。このルーチンは必須です。

GetDriveParameters

テープミニクラスドライバーの TapeMiniGetDriveParameters ルーチンへのポインター。これは、ドライブパラメーターを取得する要求を処理します。このルーチンは必須です。

GetMediaParameters

メディアパラメーターを取得する要求を処理する、テープミニクラスドライバーの TapeMiniGetMediaParameters ルーチンへのポインター。このルーチンは必須です。

GetPosition

テープミニクラスドライバーの TapeMiniGetPosition ルーチンへのポインター。テープの位置を取得する要求を処理します。このルーチンは必須です。

GetStatus

状態の要求を処理するテープミニクラスドライバーの TapeMiniGetStatus ルーチンへのポインター。このルーチンは必須です。

Prepare

テープデバイスを準備するテープミニクラスドライバーの TapeMiniPrepare ルーチンへのポインター。このルーチンは必須です。

SetDriveParameters

テープミニクラスドライバーの TapeMiniSetDriveParameters ルーチンへのポインター。これは、ドライブパラメーターを設定します。このルーチンは必須です。

SetMediaParameters

メディアパラメーターを設定するテープミニクラスドライバーの TapeMiniSetMediaParameters ルーチンへのポインター。このルーチンは必須です。

SetPosition

テープを配置するテープミニクラスドライバーの TapeMiniSetPosition ルーチンへのポインター。このルーチンは必須です。

WriteMarks

テープミニクラスドライバーの TapeMiniWriteMarks ルーチンへのポインター。テープにマークを書き込みます。このルーチンは必須です。

PreProcessReadWrite

すべての読み取りと書き込みの前にデバイス固有の操作を実行する、テープミニクラスドライバーの TapeMiniPreProcessReadWrite ルーチンへのポインター。このルーチンは省略可能であり、ほとんどのドライバーでは必要ありません。使用しない場合は、PreProcessReadWrite NULL する必要があります。

TapeGetMediaTypes

テープミニクラスドライバーの TapeMiniGetMediaTypes ルーチンへのポインター。テープデバイスでサポートされている各メディアの種類の説明を取得します。このルーチンは必須です。

MediaTypesSupported

デバイスでサポートされているメディアの種類の数を示します。

TapeWMIOperations

TapeMiniWMIControl ルーチンへのポインター。

Reserved[2]

引っ込み思案。

備考

テープミニクラスドライバーの DriverEntry ルーチンは、TapeClassZeroMemory呼び出してTAPE_INIT_DATA_EXをクリアし、必要なメンバーと適切な省略可能なメンバーを入力し、TapeClassInitializeをこの構造体へのポインターでします。

この構造体のメンバーの説明で示されているテープミニクラスドライバールーチンの名前は、単なるプレースホルダー名です。これらのルーチンのプロトタイプは、newtape.h で TAPE_PROCESS_COMMAND_ROUTINEとして宣言されています。

このプロトタイプのパラメーターの意味は、ミニクラスドライバールーチンごとに異なります。これらのパラメーターの使用方法の詳細については、各ミニクラスドライバールーチンの説明を参照してください。

必要条件

要件	価値
ヘッダー	minitape.h (Minitape.h を含む)

次の方法で共有

TAPE_INIT_DATA_EX構造体 (minitape.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース