TAPE_INIT_DATA_EX構造体 (minitape.h)

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

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

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

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として宣言されています。

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