NVML API 参考指南 (PDF) - vR570 (更旧版本) - Last updated January 29, 2025 - 发送反馈

4.22. 字段值查询

本章介绍与从 NVML 检索字段值相关的 NVML 操作

函数

nvmlReturn_t nvmlDeviceClearFieldValues ( nvmlDevice_t device, int  valuesCount, nvmlFieldValue_t* values )
nvmlReturn_t nvmlDeviceGetFieldValues ( nvmlDevice_t device, int  valuesCount, nvmlFieldValue_t* values )

函数

nvmlReturn_t nvmlDeviceClearFieldValues ( nvmlDevice_t device, int  valuesCount, nvmlFieldValue_t* values )
参数
device
要请求字段值的 GPU 的设备句柄
valuesCount
values 中应清除的条目数
values
用于保存字段值的 valuesCount 结构数组。 每次调用前都必须填充每个值的 fieldId
返回值

  • NVML_SUCCESS 如果 values 中的任何值被清除。 请注意,您必须检查每个值的 nvmlReturn 字段以获取每个单独的状态
  • NVML_ERROR_INVALID_ARGUMENT 如果 device 无效或 values 为 NULL

描述

清除设备的字段列表的值。 此 API 允许一次清除多个字段。

nvmlReturn_t nvmlDeviceGetFieldValues ( nvmlDevice_t device, int  valuesCount, nvmlFieldValue_t* values )
参数
device
要请求字段值的 GPU 的设备句柄
valuesCount
values 中应检索的条目数
values
用于保存字段值的 valuesCount 结构数组。 每次调用前都必须填充每个值的 fieldId
返回值

  • NVML_SUCCESS 如果 values 中的任何值被填充。 请注意,您必须检查每个值的 nvmlReturn 字段以获取每个单独的状态
  • NVML_ERROR_INVALID_ARGUMENT 如果 device 无效或 values 为 NULL

描述

请求设备的字段列表的值。 此 API 允许一次查询多个字段。 如果任何底层 fieldId 由相同的驱动程序调用填充,则这些 field ID 的结果将从单个调用中填充,而不是为每个 fieldId 进行驱动程序调用。


NVML API 参考指南 (PDF) - vR570 (更旧版本) - Last updated January 29, 2025 - 发送反馈