StorPortLogTelemetryEx 函数 (storport.h)

StorPortLogTelemetry 例程记录微型端口遥测事件,以帮助诊断或收集任何有用的信息。

语法

ULONG StorPortLogTelemetryEx(
  PVOID                     HwDeviceExtension,
  PSTOR_ADDRESS             StorAddress,
  PSTORPORT_TELEMETRY_EVENT Event,
  STOR_TELEMETRY_CATEGORY   Category
);

参数

HwDeviceExtension

指向主机总线适配器(HBA)的硬件设备扩展的指针。

StorAddress

存储设备设备地址。 对于适配器设备,此参数为 NULL。

Event

指向包含遥测数据有效负载的 STORPORT_TELEMETRY_EVENT 结构的指针。

Category

STOR_TELEMETRY_CATEGORY 枚举值,该值指定要记录的遥测类别。

返回值

StorPortLogTelemetryEx 返回以下状态代码之一:

返回代码 描述
STOR_STATUS_INVALID_BUFFER_SIZE Event->EventBufferLength 大于 EVENT_BUFFER_MAX_LENGTH。
STOR_STATUS_INVALID_PARAMETER 指向其中一个参数的指针为 NULL,或者对于非 NULL >EventBuffer,EventBufferLength 设置为零。
STOR_STATUS_NOT_IMPLEMENTED 此函数未在活动作系统上实现。
STOR_STATUS_SUCCESS 已成功记录遥测事件。

言论

微型端口可以调用 StorPortLogTelemetryEx,以使用微型端口自定义数据记录跟踪度量值或遥测事件。 微型端口在 类别中指定事件类别类型。

事件数据封装在 事件STORPORT_TELEMETRY_EVENT 结构中。 微型端口可以记录 8 个常规用途名称值对和最大长度为 4KB 的缓冲区,以及多个与事件相关的字段。

要求

要求 价值
标头 storport.h

另请参阅

STOR_TELEMETRY_CATEGORY

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetry