TAPE_EXTENSION_INIT_ROUTINE コールバック関数 (minitape.h)

[アーティクル]
02/29/2024

ExtensionInit は 、省略可能なドライバー固有のコンテキスト領域を初期化します。このルーチンは、テープミニクラスドライバーが読み込まれるときに TapeClassInitialize によって呼び出されます。このルーチンは省略可能です。

構文

TAPE_EXTENSION_INIT_ROUTINE TapeExtensionInitRoutine;

void TapeExtensionInitRoutine(
  [in] PVOID MinitapeExtension,
  [in] PINQUIRYDATA InquiryData,
  [in] PMODE_CAPABILITIES_PAGE ModeCapabilitiesPage
)
{...}

パラメーター

[in] MinitapeExtension

初期化時にテープミニクラスドライバーによって要求されたサイズのバッファーへのポインター。

[in] InquiryData

テープデバイスの SCSI 照会データへのポインター。

[in] ModeCapabilitiesPage

テープ装置の低レベル情報を含むバッファーへのポインター。このページの形式は QIC 157 標準で定義されており、変更される可能性があります。デバイスがモード機能ページをサポートしていない場合、これは NULL です 。

戻り値

なし

解説

テープミニクラスドライバーは、DriverEntry ルーチンから TapeClassInitialize に渡すTAPE_INIT_DATA_EX構造体の MinitapeExtensionSize に 0 以外の値を指定して、ミニテープ拡張機能を要求します。ミニクラスドライバーは、ミニテープ拡張機能の構造と内容を定義し、通常、それを使用して、サポートされているデバイスの照会データを格納します。

テープクラスドライバーは、ミニテープ拡張機能を割り当て、その後、デバイスコントロール要求のデバイス固有の側面を処理するテープミニクラスドライバーのルーチンと、ミニクラスドライバーのオプションの TapeMiniTapeError ルーチンの呼び出しで提供します。

ExtensionInit は ミニテープ拡張機能を初期化し、ミニクラスドライバーはこの領域を使用してそのデバイスの実行時状態を維持します。テープクラスドライバーは 、InquiryData と ModeCapabilitiesPage をこのルーチンに渡します。これらの構造体には、テープミニクラスドライバーがミニテープ拡張機能に格納する必要がある情報が含まれているためです。