StorPortEtwChannelEvent2 函式（storport.h）

發行項
02/07/2025

迷你埠會呼叫 StorPortEtwChannelEvent2，將具有兩個一般用途 ETW 參數的 ETW 事件記錄至指定的通道。

語法

ULONG StorPortEtwChannelEvent2(
  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
);

參數

HwDeviceExtension

[in]主機總線適配卡（HBA）的硬體裝置擴充功能指標。

Address

[in/optional]儲存單位裝置位址。這個參數是配接器裝置的NULL。

EventChannel

[in]STORPORT_ETW_EVENT_CHANNEL 值，指定要記錄事件的 Storport 通道。

EventId

[in]可唯一識別事件類型的迷你埠定義標識碼。

EventDescription

[in]描述事件的必要字串。字串的大小上限是 STORPORT_ETW_MAX_DESCRIPTION_LENGTH 個字元，不包括 null 終止符。

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意義的描述。字串的大小上限是 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 個字元，不包括 Null 終止符。

Parameter1Value

[in]參數 1 的值。

Parameter2Name

[in]Parameter2Value意義的描述。字串的大小上限是 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 個字元，不包括 Null 終止符。

Parameter2Value

[in]參數 2 的值。

傳回值

StorPortEtwChannelEvent2 會傳回下列其中一個狀態代碼：

傳回碼	描述
STOR_STATUS_SUCCESS	已成功記錄事件。
STOR_STATUS_NOT_IMPLEMENTED	記憶體事件未啟用追蹤。
STOR_STATUS_INVALID_PARAMETER	其中一個參數無效。例如，HwDeviceExtension 或 EventDescription 為 NULL、EventDescription 大於最大名稱長度，或 ETW 參數名稱大於最大名稱長度。