StorPortEtwEvent4 関数 (storport.h)
StorPortEtwEvent4 は、4 つの汎用 ETW パラメーターを持つ Windows イベント トレース (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
ミニポートのデバイス拡張機能へのポインター。
[in, optional] Address
記憶装置のデバイス アドレス。 アダプター デバイスの場合、このパラメーターは NULL です。
[in] EventId
ETW イベントのミニポート定義識別子。
[in] EventDescription
イベントの説明テキスト。 このテキスト文字列は <= STORPORT_ETW_MAX_DESCRIPTION_LENGTHである必要があります。
[in] EventKeywords
イベント分類のキーワード フラグ。 キーワード (keyword)が必要ない場合は、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
イベント レベル。 この値は、イベントの重要度または重大度を示すことができます。 これは次のいずれかの値です。
| 値 | 意味 |
|---|---|
| StorportEtwLevelLogAlways | イベントを無条件でログに記録します。 イベントは、設定されたフィルターに関係なくログに記録されます。 |
| StorportEtwLevelCritical | クリティカル レベルのイベント。 |
| StorportEtwLevelError | エラー レベル のイベント。 |
| StorportEtwLevelWarning | 警告レベルのイベント。 |
| StorportEtwLevelInformational | 情報イベント。 |
| StorportEtwLevelVerbose | 詳細なイベント情報が提供されます。 |
[in] EventOpcode
イベントの運用上の性質。 これは次のいずれかの値です。
| 値 | 意味 |
|---|---|
| StorportEtwEventOpcodeInfo | 一般的な情報イベント。 |
| StorportEtwEventOpcodeStart | デバイスまたはユニットが開始されました。 |
| StorportEtwEventOpcodeStop | デバイスまたはユニットが停止していました。 イベントは、最後にペアになっていない開始イベントに対応します。 |
| StorportEtwEventOpcodeDC_Start | データ収集開始イベント。 これらはランダウン イベントの種類です。 |
| StorportEtwEventOpcodeDC_Stop | データ収集停止イベント。 これらはランダウン イベントの種類です。 |
| StorportEtwEventOpcodeExtension | 拡張イベント。 |
| StorportEtwEventOpcodeReply | 応答イベント。 |
| StorportEtwEventOpcodeResume | 中断後にデバイスまたはユニットが再開されました。 |
| StorportEtwEventOpcodeSuspend | デバイスまたはユニットは、別の操作の完了待ちで中断されます。 |
| StorportEtwEventOpcodeReceive | アクティビティの転送は、別のコンポーネントから受け取ります。 |
[in, optional] Srb
ログに記録されたイベントに関連付けられている SRB へのポインター。 このパラメーターに有効な SRB が含まれている場合は、この SRB ポインターと関連する SRB ポインターがログに記録されます。
[in, optional] Parameter1Name
Parameter1Value の意味の説明。 このパラメーター名の文字列は= STORPORT_ETW_MAX_PARAM_NAME_LENGTHである <必要があります。
[in] Parameter1Value
パラメーター 1 の値。
[in, optional] Parameter2Name
Parameter2Value の意味の説明。 このパラメーター名の文字列は= STORPORT_ETW_MAX_PARAM_NAME_LENGTHである <必要があります。
[in] Parameter2Value
パラメーター 2 の値。
[in, optional] Parameter3Name
Parameter3Value の意味の説明。 このパラメーター名の文字列は= STORPORT_ETW_MAX_PARAM_NAME_LENGTHである <必要があります。
[in] Parameter3Value
パラメーター 3 の値。
[in, optional] Parameter4Name
Parameter4Value の意味の説明。 このパラメーター名の文字列は= 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 |
| 対象プラットフォーム | ユニバーサル |
| Header | storport.h (Storport.h を含む) |
| IRQL | <= DISPATCH_LEVEL |