次の方法で共有

StorPortEtwChannelEvent4 関数 (storport.h)

  • [アーティクル]

ミニポートは、StorPortEtwChannelEvent4 呼び出して、4 つの汎用 ETW パラメーターを持つ ETW イベントを指定されたチャネルに記録します。

構文

ULONG StorPortEtwChannelEvent4(
  PVOID                                                        HwDeviceExtension,
  PSTOR_ADDRESS                                                Address,
  STORPORT_ETW_EVENT_CHANNEL                                   EventChannel,
  ULONG                                                        EventId,
  PWSTR                                                        EventDescription,
  ULONGLONG                                                    EventKeywords,
  STORPORT_ETW_LEVEL                                           EventLevel,
  STORPORT_ETW_EVENT_OPCODE                                    EventOpcode,
  PSCSI_REQUEST_BLOCK                                          Srb,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter1Name,
  ULONGLONG                                                    Parameter1Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter2Name,
  ULONGLONG                                                    Parameter2Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter3Name,
  ULONGLONG                                                    Parameter3Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter4Name,
  ULONGLONG                                                    Parameter4Value
);

パラメーター

HwDeviceExtension

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

Address

[入力/省略可能]ストレージ・ユニット・デバイス・アドレス。 このパラメーターは、アダプター デバイスの場合は NULL です。

EventChannel

[in]イベントをログに記録する Storport チャネルを指定する STORPORT_ETW_EVENT_CHANNEL 値。

EventId

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

EventDescription

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

EventKeywords

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

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

EventLevel

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

EventOpcode

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

Srb

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

Parameter1Name

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

Parameter1Value

[in]パラメーター 1 の値。

Parameter2Name

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

Parameter2Value

[in]パラメーター 2 の値。

Parameter3Name

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

Parameter3Value

[in]パラメーター 3 の値。

Parameter4Name

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

Parameter4Value

[in]パラメーター 4 の値。

戻り値

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

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

備考

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

StorPort ミニポート ドライバーから生成されたイベントは、EventChannel で指定されたチャネル記録されます。

必要条件

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

関連項目

StorPortNvmeMiniportEventの

StorPortEtwChannelEvent2の

StorPortEtwChannelEvent8の

StorPortEtwEvent2の

StorPortEtwEvent4をする

StorPortEtwEvent8の