StorPortEtwEvent2 函式（storport.h）

發行項
2025/02/07

迷你埠會呼叫 StorPortEtwEvent2，以將具有兩個一般用途 ETW 參數的 ETW 事件記錄到記憶體追蹤通道。

語法

C++

ULONG StorPortEtwEvent2(
  [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] HwDeviceExtension

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

[in/optional] Address

儲存單位裝置位址。這個參數是配接器裝置的NULL。

[in] EventId

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

[in] EventDescription

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

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

[in] Parameter1Value

參數 1 的值。

[in/optional] Parameter2Name

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

[in] Parameter2Value

參數 2 的值。

傳回值

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

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