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 事件 ->EventBufferLength 大于 EVENT_BUFFER_MAX_LENGTH。
STOR_STATUS_INVALID_PARAMETER 指向其中一个参数的指针为 NULL,或者对于非 NULL Event-EventBuffer>,EventBufferLength 设置为零。
STOR_STATUS_NOT_IMPLEMENTED 此函数未在活动操作系统上实现。
STOR_STATUS_SUCCESS 已成功记录遥测事件。

备注

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

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

要求

   
Header storport.h

另请参阅

STOR_TELEMETRY_CATEGORY

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetry