4.17. 单元命令
本章介绍更改单元状态的 NVML 操作。适用于 S 级产品。所有这些操作都需要 root/admin 访问权限。非管理员用户在调用任何这些方法时将看到 NVML_ERROR_NO_PERMISSION 错误代码。
函数
- nvmlReturn_t nvmlUnitSetLedState ( nvmlUnit_t unit, nvmlLedColor_t color )
函数
- nvmlReturn_t nvmlUnitSetLedState ( nvmlUnit_t unit, nvmlLedColor_t color )
-
参数
- unit
- 目标单元的标识符
- color
- 目标 LED 颜色
返回值
- NVML_SUCCESS 如果 LED 颜色已设置
- NVML_ERROR_UNINITIALIZED 如果库尚未成功初始化
- NVML_ERROR_INVALID_ARGUMENT 如果 unit 或 color 无效
- NVML_ERROR_NOT_SUPPORTED 如果这不是 S 级产品
- NVML_ERROR_NO_PERMISSION 如果用户没有执行此操作的权限
- NVML_ERROR_UNKNOWN 在任何意外错误时
描述
设置单元的 LED 状态。LED 可以是绿色 (0) 或琥珀色 (1)。
适用于 S 级产品。需要 root/admin 权限。
此操作立即生效。
当前的 S 级产品不为每个单元提供唯一的 LED。因此,无论使用哪个命令指定哪个单元,前部和后部 LED 都将同时切换。
请参阅 nvmlLedColor_t 以获取可用颜色。
另请参阅