次の方法で共有

StorPortEtwLogError 関数 (storport.h)

  • [アーティクル]

StorPortEtwLogError 、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 説明 または DataBuffer が NULL であるか、DataBufferLength が 0 より大きくない。
STOR_STATUS_UNSUCCESSFUL 他の理由 (ETW ログ記録が有効になっていないなど) のために、StorPort で ETW イベントをログに記録できませんでした。

備考

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

必要条件

要件 価値
サポートされる最小クライアント Windows 10 バージョン 1903
ヘッダー storport.h

関連項目

StorPortEtwEvent2の

StorPortEtwEvent4をする

StorPortEtwEvent8の

StorPortEtwLogByteStreamの