ScsiPortLogError 関数 (srb.h)

ScsiPortLogError ルーチンは、ミニポート ドライバーまたはその HBA が SCSI エラー状態を検出すると、システム イベント ログにエラーを記録します。

注意

SCSI ポート ドライバーと SCSI ミニポート ドライバー モデルは、今後変更または使用できない可能性があります。 代わりに 、Storport ドライバー モデルと Storport ミニポート ドライバー モデルを使用してください。

構文

SCSIPORT_API VOID ScsiPortLogError(
  PVOID               HwDeviceExtension,
  PSCSI_REQUEST_BLOCK Srb,
  UCHAR               PathId,
  UCHAR               TargetId,
  UCHAR               Lun,
  ULONG               ErrorCode,
  ULONG               UniqueId
);

パラメーター

HwDeviceExtension

[入力]ハードウェア デバイス拡張機能へのポインター。 これは、ポート ドライバーが割り当て、ミニポート ドライバーの代わりに初期化する HBA ごとの記憶域です。 ミニポート ドライバーは通常、HBA の状態や HBA のマップされたアクセス範囲など、この拡張機能に HBA 固有の情報を格納します。 この領域は、ミニポート ドライバーが ScsiPortInitialize を呼び出した直後に、HBA のデバイス オブジェクトの DeviceExtension-HwDeviceExtension> メンバーのミニポート ドライバーで使用できます。 ポート ドライバーは、デバイスを削除すると、このメモリを解放します。

Srb

[入力、省略可能]エラーに関連付けられている場合は、 SCSI 要求ブロック へのポインター。 それ以外の場合、このパラメーターは NULL です。

PathId

[入力]SCSI バスを識別します。

TargetId

[入力]バス上のターゲット コントローラーまたはデバイスを識別します。

Lun

[入力]ターゲット デバイスの論理ユニット番号を識別します。

ErrorCode

[入力]エラー コードを指定します。 このパラメーターには、エラーの種類として次のいずれかの値を指定できます。

値	意味
SP_BAD_FW_ERROR	ドライバーが無効または古いファームウェアを検出したことを示します。 デバイスは使用されません。
SP_BAD_FW_WARNING	ドライバーが古いファームウェアまたは不適切なファームウェアを含むカードを検出したことを示します。これにより、パフォーマンスや機能が低下する可能性があります。
SP_BUS_PARITY_ERROR	SCSI バスパリティ エラーが検出されたことを示します。
SP_BUS_TIME_OUT	論理ユニットへの SCSI バス接続がタイムアウトしたことを示します。
SP_INTERNAL_ADAPTER_ERROR	内部 HBA エラーが検出されたことを示します。
SP_INVALID_RESELECTION	論理ユニットが予期せず、または無効なキュー タグで再選択されたことを示します。
SP_IRQ_NOT_RESPONDING	HBA が予期した場合に中断しないことを示します。
SP_PROTOCOL_ERROR	ミニポート ドライバーが SCSI バス プロトコル エラーを検出したことを示します。
SP_REQUEST_TIMEOUT	コントローラーへの操作がタイムアウトしたことを示します。
SP_UNEXPECTED_DISCONNECT	ターゲットが予期せず切断されたことを示します。

UniqueId

[入力]エラーの一意識別子を指定します。 この値は、現在のエラーと、同じ ErrorCode を持つ他のエラーを区別します。 一部のミニポート ドライバーでは、エラーが検出されたコード行を識別します。 その他の場合は、HBA によって返される追加情報です。

戻り値

なし

解説

ミニポート ドライバーは、すべての実際のハードウェア エラーをログに記録する必要があります。 ただし、選択のタイムアウトやバスのリセットなど、一般的な操作エラーをログに記録しないでください。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	srb.h (Miniport.h、Scsi.h を含む)
Library	Scsiport.lib

こちらもご覧ください

ScsiPortNotification