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
次のいずれかの値をエラーの種類として示すエラー コードを指定します。
| 値 | 意味 |
|---|---|
| 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 | ターゲットが予期せず切断されたことを示します。 |
[in] UniqueId
エラーの一意識別子を指定します。 この値は、現在のエラーと、同じ ErrorCode 値を持つ他のエラーとを区別します。 一部のミニポート ドライバーでは、エラーが検出されたコード行を識別します。 その他の場合は、HBA によって返される追加情報です。
戻り値
なし
解説
ポート ドライバーは、システム イベント ログにエラーを記録します。
Windows 8以降、Srb パラメーターは、SCSI_REQUEST_BLOCKまたはSTORAGE_REQUEST_BLOCKを指す場合があります。 Srb の Function フィールドの関数識別子がSRB_FUNCTION_STORAGE_REQUEST_BLOCK場合、SRB はSTORAGE_REQUEST_BLOCK要求構造体です。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | storport.h (Storport.h を含む) |
| Library | Storport.lib |
| DDI コンプライアンス規則 | StorPortDeprecated(storport) |