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 |