StorPortEtwChannelEvent8 関数 (storport.h)

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

構文

ULONG StorPortEtwChannelEvent8(
  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,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter5Name,
  ULONGLONG                                                    Parameter5Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter6Name,
  ULONGLONG                                                    Parameter6Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter7Name,
  ULONGLONG                                                    Parameter7Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter8Name,
  ULONGLONG                                                    Parameter8Value
);

パラメーター

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 の値。

Parameter5Name

[入力/省略可能]Parameter5Value 意味の説明。 文字列の最大サイズは、null ターミネータを含まない STORPORT_ETW_MAX_PARAM_NAME_LENGTH 文字です。

Parameter5Value

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

Parameter6Name

[入力/省略可能]Parameter6Value の意味説明します。 文字列の最大サイズは、null ターミネータを含まない STORPORT_ETW_MAX_PARAM_NAME_LENGTH 文字です。

Parameter6Value

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

Parameter7Name

[入力/省略可能]Parameter7Value 意味の説明。 文字列の最大サイズは、null ターミネータを含まない STORPORT_ETW_MAX_PARAM_NAME_LENGTH 文字です。

Parameter7Value

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

Parameter8Name

[入力/省略可能]Parameter8Value の意味説明します。 文字列の最大サイズは、null ターミネータを含まない STORPORT_ETW_MAX_PARAM_NAME_LENGTH 文字です。

Parameter8Value

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

戻り値

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

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

備考

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

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

必要条件

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

関連項目

StorPortNvmeMiniportEventの

StorPortEtwChannelEvent2の

StorPortEtwChannelEvent4の

StorPortEtwEvent2の

StorPortEtwEvent4をする

StorPortEtwEvent8の

  • Last updated on