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 进行驱动程序调用。