NVML API 参考指南 (PDF) - vR570 (更旧版本) - 最后更新于 2025 年 1 月 29 日 - 发送反馈

5.25. nvmlFieldValue_t 结构体参考

[字段值枚举]

字段值采样的信息

公共变量

unsigned int  fieldId
要检索的 NVML 字段的 ID。在使用此结构体的任何调用之前,必须设置此项。请参阅以 NVML_FI_ 开头的常量。
long long  latencyUsec
此字段值在 NVML 中更新所花费的时间(以微秒为单位)。这可能是由同一驱动程序调用服务的多个字段的平均值。
nvmlReturn_t nvmlReturn
检索此值的返回代码。在查看值之前必须检查此项,因为如果 nvmlReturn != NVML_SUCCESS,则值是未定义的。
unsigned int  scopeId
Scope ID 可以表示 NVML 使用的数据,具体取决于 fieldId 的上下文。例如,对于 NVLink 吞吐量计数器数据,scopeId 可以表示 linkId。
long long  timestamp
自 1970 年以来此值的 CPU 时间戳,以微秒为单位。
union nvmlValue_t value
此字段的值。仅当 nvmlReturn == NVML_SUCCESS 时,此值才有效。
nvmlValueType_t valueType
存储在 value 中的值的类型。

变量

unsigned int nvmlFieldValue_t::fieldId [继承]

要检索的 NVML 字段的 ID。在使用此结构体的任何调用之前,必须设置此项。请参阅以 NVML_FI_ 开头的常量。

long long nvmlFieldValue_t::latencyUsec [继承]

此字段值在 NVML 中更新所花费的时间(以微秒为单位)。这可能是由同一驱动程序调用服务的多个字段的平均值。

nvmlReturn_tnvmlFieldValue_t::nvmlReturn [继承]

检索此值的返回代码。在查看值之前必须检查此项,因为如果 nvmlReturn != NVML_SUCCESS,则值是未定义的。

unsigned int nvmlFieldValue_t::scopeId [继承]

Scope ID 可以表示 NVML 使用的数据,具体取决于 fieldId 的上下文。例如,对于 NVLink 吞吐量计数器数据,scopeId 可以表示 linkId。

long long nvmlFieldValue_t::timestamp [继承]

自 1970 年以来此值的 CPU 时间戳,以微秒为单位。

union nvmlValue_tnvmlFieldValue_t::value [继承]

此字段的值。仅当 nvmlReturn == NVML_SUCCESS 时,此值才有效。

nvmlValueType_tnvmlFieldValue_t::valueType [继承]

存储在 value 中的值的类型。


NVML API 参考指南 (PDF) - vR570 (更旧版本) - 最后更新于 2025 年 1 月 29 日 - 发送反馈