函数

nvmlReturn_t nvmlGpmMetricsGet ( nvmlGpmMetricsGet_t* metricsGet )

参数

metricsGet

输入/输出：已填充的 nvmlGpmMetricsGet_t 结构体

返回值

• NVML_SUCCESS 成功时返回
• 错误时返回非零 NVML_ERROR_? 枚举值

描述

从两个样本计算 GPM 指标。

适用于 Hopper 或更新的完全支持的设备。

nvmlReturn_t nvmlGpmMigSampleGet ( nvmlDevice_t device, unsigned int  gpuInstanceId, nvmlGpmSample_t gpmSample )

参数

device

获取样本的设备

gpuInstanceId

MIG GPU 实例 ID

gpmSample

用于读取样本的缓冲区

返回值

• NVML_SUCCESS 成功时返回
• 错误时返回非零 NVML_ERROR_? 枚举值

描述

将 GPM 指标的样本读取到为 MIG GPU 实例提供的 gpmSample 缓冲区中。

收集到两个样本后，您可以对这些样本调用 nvmlGpmMetricGet 以检索指标

适用于 Hopper 或更新的完全支持的设备。

nvmlReturn_t nvmlGpmQueryDeviceSupport ( nvmlDevice_t device, nvmlGpmSupport_t* gpmSupport )

参数

device

要查询的 NVML 设备

gpmSupport

用于指示 GPM 支持的结构体 nvmlGpmSupport_t。指示所提供设备的每个系统的 GPM 支持情况

返回值

• NVML_SUCCESS 成功时返回
• 如果处理查询时出错，则返回非零 NVML_ERROR_? 枚举值

描述

指示提供的设备是否支持 GPM

nvmlReturn_t nvmlGpmQueryIfStreamingEnabled ( nvmlDevice_t device, unsigned int* state )

参数

device

目标设备的标识符

state

返回 GPM 流状态 NVML_FEATURE_DISABLED 或 NVML_FEATURE_ENABLED

返回值

• NVML_SUCCESS 如果成功查询到当前 GPM 流状态
• NVML_ERROR_UNINITIALIZED 如果库尚未成功初始化
• NVML_ERROR_INVALID_ARGUMENT 如果设备无效或状态为空
• NVML_ERROR_NOT_SUPPORTED 如果设备不支持此查询

描述

获取 GPM 流状态。

适用于 Hopper 或更新的完全支持的设备。在 Linux、Windows TCC 上受支持。

nvmlReturn_t nvmlGpmSampleAlloc ( nvmlGpmSample_t* gpmSample )

参数

gpmSample

分配的样本将存储在此处

返回值

• NVML_SUCCESS 成功时返回
• NVML_ERROR_INVALID_ARGUMENT 如果提供了无效指针
• NVML_ERROR_MEMORY 如果系统内存不足

描述

分配一个样本缓冲区以用于 NVML GPM。您需要分配至少两个这样的缓冲区才能使用 NVML GPM 功能

适用于 Hopper 或更新的完全支持的设备。

nvmlReturn_t nvmlGpmSampleFree ( nvmlGpmSample_t* gpmSample )

参数

gpmSample

要释放的样本

返回值

• NVML_SUCCESS 成功时返回
• NVML_ERROR_INVALID_ARGUMENT 如果提供了无效指针

描述

释放使用 nvmlGpmSampleAlloc() 分配的样本缓冲区

适用于 Hopper 或更新的完全支持的设备。

nvmlReturn_t nvmlGpmSampleGet ( nvmlDevice_t device, nvmlGpmSample_t gpmSample )

参数

device

获取样本的设备

gpmSample

用于读取样本的缓冲区

返回值

• NVML_SUCCESS 成功时返回
• 错误时返回非零 NVML_ERROR_? 枚举值

描述

将 GPM 指标的样本读取到提供的 gpmSample 缓冲区中。收集到两个样本后，您可以对这些样本调用 nvmlGpmMetricGet 以检索指标

适用于 Hopper 或更新的完全支持的设备。

nvmlReturn_t nvmlGpmSetStreamingEnabled ( nvmlDevice_t device, unsigned int  state )

参数

device

目标设备的标识符

state

GPM 流状态，NVML_FEATURE_DISABLED 或 NVML_FEATURE_ENABLED

返回值

• NVML_SUCCESS 如果成功设置了当前 GPM 流状态
• NVML_ERROR_UNINITIALIZED 如果库尚未成功初始化
• NVML_ERROR_INVALID_ARGUMENT 如果设备无效
• NVML_ERROR_NOT_SUPPORTED 如果设备不支持此查询

描述

设置 GPM 流状态。

适用于 Hopper 或更新的完全支持的设备。在 Linux、Windows TCC 上受支持。