函数

nvmlReturn_t nvmlDeviceWorkloadPowerProfileClearRequestedProfiles ( nvmlDevice_t device, nvmlWorkloadPowerProfileRequestedProfiles_t* requestedProfiles )

参数

device

目标设备的标识符

requestedProfiles

指向结构体 nvmlWorkloadPowerProfileRequestedProfiles_v1_t 的引用

返回值

• NVML_SUCCESS 如果查询成功
• NVML_ERROR_UNINITIALIZED 如果库未成功初始化
• NVML_ERROR_INVALID_ARGUMENT 如果设备无效或指向结构体的指针为空
• NVML_ERROR_NOT_SUPPORTED 如果设备不支持此功能
• NVML_ERROR_GPU_IS_LOST 如果目标 GPU 已从总线上脱落或无法访问
• NVML_ERROR_ARGUMENT_VERSION_MISMATCH 如果提供的版本无效/不受支持
• NVML_ERROR_UNKNOWN 如果发生任何意外错误

描述

清除请求的性能配置文件

BLACKWELL_OR_NEWER% 有关结构体的更多信息，请参阅 nvmlWorkloadPowerProfileRequestedProfiles_v1_t。通过使用输入位掩码 requestedProfilesMask 清除一个或多个性能配置文件，其中设置的每个位对应于 perfProfilesMask 中的一个支持位。这些配置文件将从当前请求的配置文件列表中删除。

nvmlReturn_t nvmlDeviceWorkloadPowerProfileGetCurrentProfiles ( nvmlDevice_t device, nvmlWorkloadPowerProfileCurrentProfiles_t* currentProfiles )

参数

device

目标设备的标识符

currentProfiles

指向结构体 nvmlWorkloadPowerProfileCurrentProfiles_v1_t 的引用

返回值

• NVML_SUCCESS 如果查询成功
• NVML_ERROR_UNINITIALIZED 如果库未成功初始化
• NVML_ERROR_INVALID_ARGUMENT 如果设备无效或指向结构体的指针为空
• NVML_ERROR_NOT_SUPPORTED 如果设备不支持此功能
• NVML_ERROR_GPU_IS_LOST 如果目标 GPU 已从总线上脱落或无法访问
• NVML_ERROR_ARGUMENT_VERSION_MISMATCH 如果提供的版本无效/不受支持
• NVML_ERROR_UNKNOWN 如果发生任何意外错误

描述

获取当前性能配置文件

BLACKWELL_OR_NEWER% 有关结构体的更多信息，请参阅 nvmlWorkloadPowerProfileCurrentProfiles_v1_t。此 API 返回一个结构体，其中包含当前的 perfProfilesMask、requestedProfilesMask 和 enforcedProfilesMask。每个位掩码中设置的每个位分别指示配置文件是否受支持、当前请求或当前已启用。

nvmlReturn_t nvmlDeviceWorkloadPowerProfileGetProfilesInfo ( nvmlDevice_t device, nvmlWorkloadPowerProfileProfilesInfo_t* profilesInfo )

参数

device

目标设备的标识符

profilesInfo

指向结构体 nvmlWorkloadPowerProfileProfilesInfo_t 的引用

返回值

• NVML_SUCCESS 如果查询成功
• NVML_ERROR_INSUFFICIENT_SIZE 如果结构体大小不足
• NVML_ERROR_UNINITIALIZED 如果库未成功初始化
• NVML_ERROR_INVALID_ARGUMENT 如果设备无效或指向结构体的指针为空
• NVML_ERROR_NOT_SUPPORTED 如果设备不支持此功能
• NVML_ERROR_GPU_IS_LOST 如果目标 GPU 已从总线上脱落或无法访问
• NVML_ERROR_ARGUMENT_VERSION_MISMATCH 如果提供的版本无效/不受支持
• NVML_ERROR_UNKNOWN 如果发生任何意外错误

描述

获取性能配置文件信息

BLACKWELL_OR_NEWER% 有关结构体的更多信息，请参阅 nvmlWorkloadPowerProfileProfilesInfo_v1_t。掩码 perfProfilesMask 是所有受支持模式索引的位掩码，其中如果索引为 1，则该模式受支持。每个受支持的模式在 perfProfile 数组中都有一个对应的条目，其中将包含 profileId、此模式的优先级（值越低，优先级越高）以及 conflictingMask，其中掩码中设置的每个位对应于不能与给定配置文件结合使用的不同配置文件。

nvmlReturn_t nvmlDeviceWorkloadPowerProfileSetRequestedProfiles ( nvmlDevice_t device, nvmlWorkloadPowerProfileRequestedProfiles_t* requestedProfiles )

参数

device

目标设备的标识符

requestedProfiles

指向结构体 nvmlWorkloadPowerProfileRequestedProfiles_v1_t 的引用

返回值

• NVML_SUCCESS 如果查询成功
• NVML_ERROR_UNINITIALIZED 如果库未成功初始化
• NVML_ERROR_INVALID_ARGUMENT 如果设备无效或指向结构体的指针为空
• NVML_ERROR_NOT_SUPPORTED 如果设备不支持此功能
• NVML_ERROR_GPU_IS_LOST 如果目标 GPU 已从总线上脱落或无法访问
• NVML_ERROR_ARGUMENT_VERSION_MISMATCH 如果提供的版本无效/不受支持
• NVML_ERROR_UNKNOWN 如果发生任何意外错误

描述

设置请求的性能配置文件

BLACKWELL_OR_NEWER% 有关结构体的更多信息，请参阅 nvmlWorkloadPowerProfileRequestedProfiles_v1_t。请求使用输入位掩码 requestedProfilesMask 激活一个或多个性能配置文件，其中设置的每个位对应于 perfProfilesMask 中的一个支持位。这些配置文件将添加到当前请求的配置文件列表中。