通过

StorPortNvmeLogTelemetry 函数 （storport.h）

  • 项目

NMVe 微型端口驱动程序调用 StorPortNvmeLogTelemetry 函数来记录 NVMe 设备的遥测事件。

语法

ULONG StorPortNvmeLogTelemetry(
  PVOID                     HwDeviceExtension,
  PVOID                     ControllerHandle,
  ULONG                     NamespaceId,
  PSTORPORT_TELEMETRY_EVENT Event,
  STOR_TELEMETRY_CATEGORY   Category
);

参数

HwDeviceExtension

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

ControllerHandle

[in/optional]对于构造 NVMe 微型端口，如果事件特定于控制器，ControllerHandle 是 StorPort 的 NVMe 控制器的句柄。 否则，ControllerHandle 应为 NULL。

NamespaceId

[in]如果事件特定于命名空间，NamespaceId 是命名空间标识符。 否则，NamespaceId 应为 0。

Event

[in]指向包含标准事件字段和微型端口有效负载数据的 STORPORT_TELEMTRY_EVENT 结构的指针。

Category

[in]指定要记录的遥测类别的 STOR_TELEMETRY_CATEGORY 值。

返回值

StorPortNvmeLogTelemetry 成功记录遥测事件时返回 STOR_STATUS_SUCCESS。 否则，它将返回STOR_STATUS错误代码，如下所示：

返回代码 描述
STOR_STATUS_NOT_IMPLEMENTED 此函数未在活动作系统上实现。
STOR_STATUS_INVALID_PARAMETER 如果一个或多个参数无效，则作将失败并返回此返回值。

言论

NVMe 微型端口可以调用此函数，以使用封装在 事件中封装的微型端口自定义数据记录跟踪记录度量值事件。

StorPortNvmeLogTelemetry 还允许调用方指定 telemtry 类别类型。

要求

要求 价值
最低支持的客户端 Windows 11 版本 24H2
标头 storport.h

另请参阅

STOR_TELEMETRY_CATEGORY

STORPORT_TELEMTRY_EVENT