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 |