StorPortEtwLogError 関数 (storport.h)

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

StorPortEtwLogError は 、ハードウェアプロトコルエラーのイベントトレーシング for Windows (ETW) イベントをログに記録します。

構文

ULONG StorPortEtwLogError(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Id,
  [in]           PWSTR         Description,
  [in]           ULONG         DataBufferLength,
  [in]           PVOID         DataBuffer
);

パラメーター

[in] HwDeviceExtension

ミニポートのデバイス拡張機能へのポインター。

[in, optional] Address

ストレージ・ユニットのデバイス・アドレス。このパラメーターは、アダプターデバイスの場合は NULL です。

[in] Id

イベントを一意に識別するミニポート定義イベント ID。

[in] Description

エラーの説明テキスト。このパラメーターは必須です。

[in] DataBufferLength

DataBuffer のサイズ (バイト単位)。

[in] DataBuffer

エラーの原因を特定するのに役立つドライバー固有のバイナリデータを含む可変サイズのバッファー。ドライバーは、 DataBufferLength パラメーターでこのバッファーのサイズを指定する必要があります。

戻り値

この関数は、次のいずれかの状態コードを返します。

リターンコード	説明
STOR_STATUS_SUCCESS	イベントが正常にログに記録されました。
STOR_STATUS_INVALID_PARAMETER	Description または DataBuffer が NULL であるか、 DataBufferLength が 0 より大きくない。
STOR_STATUS_UNSUCCESSFUL	ETW ログ記録が有効になっていないなど、他の理由で StorPort で ETW イベントをログに記録できませんでした。

注釈

ミニポートは StorPortEtwLogError を呼び出して、ハードウェアプロトコルエラーの ETW イベントをログに記録できます。この関数から生成されたイベントは、"Microsoft-Windows-Storage-Storport/Operational" ETW チャネルに発行されます。