StorPortEtwChannelEvent4 函数（storport.h）

项目
02/07/2025

微型端口调用 StorPortEtwChannelEvent4，以将具有四个常规用途 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

[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 的值。

Parameter3Name

[in]Parameter3Value的含义的说明。字符串的最大大小是 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 个字符，不包括 null 终止符。

Parameter3Value

[in]参数 3 的值。

Parameter4Name

[in]Parameter4Value的含义的说明。字符串的最大大小是 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 个字符，不包括 null 终止符。

Parameter4Value

[in]参数 4 的值。

返回值

StorPortEtwChannelEvent4 返回以下状态代码之一：

返回代码	描述
STOR_STATUS_SUCCESS	已成功记录该事件。
STOR_STATUS_NOT_IMPLEMENTED	未为存储事件启用跟踪。
STOR_STATUS_INVALID_PARAMETER	其中一个参数无效。例如，HwDeviceExtension 或 EventDescription 为 NULL，EventDescription 大于最大名称长度，或者 ETW 参数名称大于最大名称长度。