4.31. 电源平滑信息
类型定义
- typedef nvmlPowerSmoothingProfile_v1_t nvmlPowerSmoothingProfile_t
- 电源平滑配置文件结构的当前版本。
- typedef nvmlPowerSmoothingState_v1_t nvmlPowerSmoothingState_t
- 电源平滑状态结构的当前版本。
函数
- nvmlReturn_t nvmlDevicePowerSmoothingActivatePresetProfile ( nvmlDevice_t device, nvmlPowerSmoothingProfile_t* profile )
- nvmlReturn_t nvmlDevicePowerSmoothingSetState ( nvmlDevice_t device, nvmlPowerSmoothingState_t* state )
- nvmlReturn_t nvmlDevicePowerSmoothingUpdatePresetProfileParam ( nvmlDevice_t device, nvmlPowerSmoothingProfile_t* profile )
类型定义
函数
- nvmlReturn_t nvmlDevicePowerSmoothingActivatePresetProfile ( nvmlDevice_t device, nvmlPowerSmoothingProfile_t* profile )
-
参数
- device
- 目标设备的标识符
- profile
- 指向 nvmlPowerSmoothingProfile_t 的引用。请注意,仅使用 profile->profileId,结构的其余部分将被忽略。
返回值
- 如果成功设置了所需的配置文件,则返回 NVML_SUCCESS
- 如果设备无效或结构为 NULL,则返回 NVML_ERROR_INVALID_ARGUMENT
- 如果用户没有更改配置文件编号的权限,则返回 NVML_ERROR_NO_PERMISSION
- 如果设备不支持此功能,则返回 NVML_ERROR_NOT_SUPPORTED
描述
为数据中心电源平滑激活特定的预设配置文件。该 API 仅根据输入的 profileId 设置活动的预设配置文件,并忽略结构的其他参数。
- nvmlReturn_t nvmlDevicePowerSmoothingSetState ( nvmlDevice_t device, nvmlPowerSmoothingState_t* state )
-
参数
- device
- 目标设备的标识符
- state
- 指向 nvmlPowerSmoothingState_t 的引用
返回值
- 如果成功设置了功能状态,则返回 NVML_SUCCESS
- 如果设备无效或状态为 NULL,则返回 NVML_ERROR_INVALID_ARGUMENT
- 如果用户没有更改功能状态的权限,则返回 NVML_ERROR_NO_PERMISSION
- 如果设备不支持此功能,则返回 NVML_ERROR_NOT_SUPPORTED
描述
启用或禁用电源平滑功能。 有关允许的状态的详细信息,请参阅 nvmlEnableState_t
- nvmlReturn_t nvmlDevicePowerSmoothingUpdatePresetProfileParam ( nvmlDevice_t device, nvmlPowerSmoothingProfile_t* profile )
-
参数
- device
- 目标设备的标识符
- profile
- 指向 nvmlPowerSmoothingProfile_t 结构的引用
返回值
- 如果成功设置了活动配置文件,则返回 NVML_SUCCESS
- 如果设备无效或配置文件参数/值无效,则返回 NVML_ERROR_INVALID_ARGUMENT
- 如果用户没有更改任何配置文件参数的权限,则返回 NVML_ERROR_NO_PERMISSION
- 如果结构版本不受支持,则返回 NVML_ERROR_ARGUMENT_VERSION_MISMATCH
描述
更新 nvmlPowerSmoothingProfile_t 中包含的特定配置文件参数的值
NVML_POWER_SMOOTHING_PROFILE_PARAM_PERCENT_TMP_FLOOR 期望的值为 00.00-100.00% 的百分比。NVML_POWER_SMOOTHING_PROFILE_PARAM_RAMP_UP_RATE 期望的值单位为 W/s。NVML_POWER_SMOOTHING_PROFILE_PARAM_RAMP_DOWN_RATE 期望的值单位为 W/s。NVML_POWER_SMOOTHING_PROFILE_PARAM_RAMP_DOWN_HYSTERESIS 期望的值单位为 ms。