StorPortLogTelemetry 函数 (storport.h)

  • 项目

StorPortLogTelemetry 例程记录微型端口遥测事件，以帮助诊断或收集任何有用的信息。 微型端口可以记录 8 个常规用途名称/值对和最大长度为 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 结构中的任何参数未命名为 Event-ParameterNameX> == NULL，则例程会将相应的参数值设置为 0。

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

要求

要求 值
最低受支持的客户端 Windows 10 版本 1703
最低受支持的服务器 Windows Server 2016
目标平台 Windows
标头 storport.h (包括 Storport.h)
IRQL 任意

另请参阅

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx