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

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

TAPE_ERROR_ROUTINE では、SRB がエラー状態で完了したときに、デバイス固有のエラー処理が提供されます。このルーチンは省略可能です。

構文

TAPE_ERROR_ROUTINE TapeErrorRoutine;

void TapeErrorRoutine(
  [in]      PVOID MinitapeExtension,
  [in]      PSCSI_REQUEST_BLOCK Srb,
  [in, out] PTAPE_STATUS TapeStatus
)
{...}

パラメーター

[in] MinitapeExtension

ドライバー固有のミニテープ拡張機能へのポインター。ミニクラスドライバーが初期化時にミニテープ拡張機能を要求しなかった場合、これは NULL です。

[in] Srb

失敗した操作の SRB へのポインター。

[in, out] TapeStatus

テープクラスドライバーによって設定されたTAPE_STATUS へのポインター。テープミニクラスドライバーは、TAPE_STATUSを変更するか、変更せずに残すことができます。

戻り値

なし

解説

ほとんどのテープミニクラスドライバーは、テープクラスドライバーによって設定 されたTAPE_STATUS コードが適切であるため、TAPE_ERROR_ROUTINE ルーチンを提供しません。

ただし、一部のデバイスでは、テープミニクラスドライバーは、テープクラスドライバーよりも適切なエラーコードを識別できます。たとえば、テープクラスドライバーがTAPE_STATUS_BUS_RESETを返す場合、テープミニクラスドライバーは、実際の問題が一部のデバイスのTAPE_STATUS_NO_MEDIAによってより正確に表されていることを判断できる場合があります。

テープミニクラスドライバーは、必要に応じて、DriverEntryルーチンからTapeClassInitialize に渡すTAPE_INIT_DATA_EX構造体のTAPE_ERROR_ROUTINE ルーチンのエントリポイントを指定します。このようなミニクラスドライバーの場合、読み取り、書き込み、またはデバイス制御コマンド中にエラーが発生すると、テープクラスドライバーは適切なTAPE_STATUS コードを設定し、ミニテープ拡張機能、失敗した SRB、および返されるTAPE_STATUS コードを使用してミニクラスドライバーの TAPE_ERROR_ROUTINE ルーチンを呼び出します。

TAPE_ERROR_ROUTINE は、入力パラメーターとそのデバイスの知識に基づいて、テープクラスドライバーによって提供される状態を変更するかどうかを決定します。 SRB_STATUS_AUTOSENSE_VALID ビットが Srb-SrbStatus> で設定されている場合、SRB には SenseInfoBuffer の SCSI センス情報が含まれます。バッファーの長さは SenseInfoBufferLength です。 TAPE_ERROR_ROUTINE ルーチンは、SRB 内の SrbStatus および ScsiStatus と共にこの情報を調べて、返されるTAPE_STATUSを変更するかどうかを判断する必要があります。