通过

StorPortLogTelemetry 函数 （storport.h）

  • 项目

StorPortLogTelemetry 例程记录微型端口遥测事件，以帮助诊断或收集任何有用的信息。 微型端口可以记录八个常规用途名称/值对和最大长度为 4KB 的缓冲区，以及结构 STORPORT_TELEMETRY_EVENT中定义的多个事件相关字段。

语法

ULONG StorPortLogTelemetry(
  [in]           PVOID                     HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS             StorAddress,
  [in]           PSTORPORT_TELEMETRY_EVENT Event
);

参数

[in] HwDeviceExtension

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

[in, optional] StorAddress

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

[in] Event

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

返回值

StorPortLogTelemetry 返回以下状态代码之一：

返回代码 描述
STOR_STATUS_INVALID_BUFFER_SIZE
 EventBufferLength 大于 EVENT_BUFFER_MAX_LENGTH。
STOR_STATUS_INVALID_PARAMETER
 指向其中一个参数的指针为 NULL 或事件结构中的 EventBufferLength/EventBuffer 不匹配。
STOR_STATUS_NOT_IMPLEMENTED
 此函数未在活动作系统上实现。
STATUS_SUCCESS
 遥测事件数据已成功记录。

言论

如果未命名事件结构中的任何参数，Event->ParameterNameX == NULL，则例程会将相应的参数值设置为 0。

如果微型端口没有有效负载来填充 Event->EventBuffer，则应设置 Event->EventBufferLength = 0，以及 Event->EventBuffer = NULL。

要求

要求 价值
最低支持的客户端 Windows 10 版本 1703
支持的最低服务器 Windows Server 2016
目标平台 窗户
标头 storport.h （包括 Storport.h）
IRQL 任何

另请参阅

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx