StorPortEtwEvent4 関数 (storport.h)

[アーティクル]
02/07/2025

ミニポートは、StorPortEtwEvent4 呼び出して、4 つの汎用 ETW パラメーターを持つ ETW イベントをストレージトレースチャネルに記録します。

構文

ULONG StorPortEtwEvent4(
  [in]          PVOID                                                        HwDeviceExtension,
  [in/optional] PSTOR_ADDRESS                                                Address,
  [in]          ULONG                                                        EventId,
  [in]          PWSTR                                                        EventDescription,
  [in]          ULONGLONG                                                    EventKeywords,
  [in]          STORPORT_ETW_LEVEL                                           EventLevel,
  [in]          STORPORT_ETW_EVENT_OPCODE                                    EventOpcode,
  [in/optional] PSCSI_REQUEST_BLOCK                                          Srb,
  [in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter1Name,
  [in]          ULONGLONG                                                    Parameter1Value,
  [in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter2Name,
  [in]          ULONGLONG                                                    Parameter2Value,
  [in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter3Name,
  [in]          ULONGLONG                                                    Parameter3Value,
  [in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter4Name,
  [in]          ULONGLONG                                                    Parameter4Value
);

パラメーター

[in] HwDeviceExtension

ホストバスアダプター (HBA) のハードウェアデバイス拡張機能へのポインター。

[in/optional] Address

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

[in] EventId

イベントの種類を一意に識別するためのミニポート定義識別子。

[in] EventDescription

イベントを説明する必須の文字列。文字列の最大サイズは、null ターミネータを含まない STORPORT_ETW_MAX_DESCRIPTION_LENGTH 文字です。

[in] EventKeywords

イベント分類のキーワードフラグ。キーワードが必要ない場合は 0 に設定します。キーワードは、次のビットごとの OR の組み合わせです。

価値	意味
STORPORT_ETW_EVENT_KEYWORD_IO	イベントは、デバイス IO 操作に関連します。
STORPORT_ETW_EVENT_KEYWORD_PERFORMANCE	イベントはパフォーマンスに関連します。
STORPORT_ETW_EVENT_KEYWORD_POWER	イベントはデバイスの電源に関連しています。
STORPORT_ETW_EVENT_KEYWORD_ENUMERATION	イベントは、デバイスの列挙に関連します。

[in] EventLevel

イベントの重要度または重大度を指定する STORPORT_ETW_LEVEL 値。

[in] EventOpcode

イベントの運用上の性質を指定する STORPORT_ETW_EVENT_OPCODE 値。

[in/optional] Srb

ログに記録されたイベントに関連付けられている SRB へのポインター。このパラメーターに有効な SRB が含まれている場合、この SRB ポインターと関連する SRB ポインターがログに記録されます。

[in/optional] Parameter1Name

Parameter1Value の意味説明します。文字列の最大サイズは、null ターミネータを含まない STORPORT_ETW_MAX_PARAM_NAME_LENGTH 文字です。

[in] Parameter1Value

パラメーター 1 の値。

[in/optional] Parameter2Name

Parameter2Value 意味の説明。文字列の最大サイズは、null ターミネータを含まない STORPORT_ETW_MAX_PARAM_NAME_LENGTH 文字です。

[in] Parameter2Value

パラメーター 2 の値。

[in/optional] Parameter3Name

Parameter3Value の意味説明します。文字列の最大サイズは、null ターミネータを含まない STORPORT_ETW_MAX_PARAM_NAME_LENGTH 文字です。

[in] Parameter3Value

パラメーター 3 の値。

[in/optional] Parameter4Name

Parameter4Value の意味説明します。文字列の最大サイズは、null ターミネータを含まない STORPORT_ETW_MAX_PARAM_NAME_LENGTH 文字です。

[in] Parameter4Value

パラメーター 4 の値。

戻り値

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

リターンコード	形容
STOR_STATUS_SUCCESS	イベントが正常にログに記録されました。
STOR_STATUS_NOT_IMPLEMENTED	ストレージイベントに対してトレースが有効になっていません。
STOR_STATUS_INVALID_PARAMETER	いずれかのパラメーターが無効です。たとえば、HwDeviceExtension または EventDescription が NULL、EventDescription が最大名前の長さを超える、ETW パラメーター名が最大名前の長さを超えています。

備考

ミニポートは、StorPortEtwEvent4 呼び出して、4 つの汎用 ETW パラメーターをログに記録できます。 ETW パラメーターは、4 つの名前と値のペアとして表されます。パラメーターの名前が指定されていない場合 (パラメーターXName = NULL)、ルーチンは対応するパラメーター値を 0 に設定します。

StorPort ミニポートドライバーから生成されたイベントは、"Microsoft-Windows-Storage-Storport/Diagnose" ETW チャネルに記録されます。

必要条件

要件	価値
サポートされる最小クライアント	Windows 8.1
ターゲットプラットフォームの	万国
ヘッダー	storport.h (Storport.h を含む)
IRQL	<= DISPATCH_LEVEL

次の方法で共有

StorPortEtwEvent4 関数 (storport.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース