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