StorPortLogError 関数 (storport.h)

StorPortLogError ルーチンは、エラーが発生したことをポート ドライバーに通知します。

構文

STORPORT_API VOID StorPortLogError(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           UCHAR               PathId,
  [in]           UCHAR               TargetId,
  [in]           UCHAR               Lun,
  [in]           ULONG               ErrorCode,
  [in]           ULONG               UniqueId
);

パラメーター

[in] HwDeviceExtension

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

[in, optional] Srb

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

[in] PathId

SCSI バスを識別します。

[in] TargetId

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

[in] Lun

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

[in] ErrorCode

次のいずれかの値をエラーの種類として示すエラー コードを指定します。

[in] UniqueId

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

戻り値

なし

解説

ポート ドライバーは、システム イベント ログにエラーを記録します。

Windows 8以降、Srb パラメーターは、SCSI_REQUEST_BLOCKまたはSTORAGE_REQUEST_BLOCKを指す場合があります。 Srb の Function フィールドの関数識別子がSRB_FUNCTION_STORAGE_REQUEST_BLOCK場合、SRB はSTORAGE_REQUEST_BLOCK要求構造体です。

要件

こちらもご覧ください

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

ScsiPortLogError

StorPortLogSystemEvent