描述单盏灯的一组预期用途。
语法
enum class LampPurposes : uint32_t
{
Undefined = 0x00,
Control = 0x01,
Accent = 0x02,
Branding = 0x04,
Status = 0x08,
Illumination = 0x10,
Presentation = 0x20
};
DEFINE_ENUM_FLAG_OPERATORS(LampPurposes);
常量
| 常量 | 说明 |
|---|---|
| Undefined | 没有为此灯指定 LampPurpose。 |
| 控制 | 灯与设备上的控件（例如按钮、键、滑块）相关联。 |
| 突出 | 灯用于美观装饰目的，不与用户交互（例如，机箱风扇 LED、键盘上的照明侧面板）。 |
| 品牌 | 灯用于设备品牌打造（例如，制造商徽标）。 |
| Status | 灯用于指示系统状态信息（例如，未读电子邮件、CPU 温度）。 |
| 照明 | 灯将 LampArray 外部的对象照亮（例如，舞台聚光灯、汽车头灯、相机闪烁）。 |
| 演示 | 用户直接看到的灯（例如，在艺术品或服装中）。 |
备注
此列表将来很可能会扩展，因此不要使用错误检查来验证 LampPurpose 是否在当前边界内。 首选方法是与应用程序支持的 LampPurpose 子集进行比较。
要求
头文件：在 LampArray.h 中声明。
另请参阅
照明 API 概述
ILampArray::GetIndicesCountForPurposes
ILampArray::GetIndicesForPurposes
ILampInfo::GetPurposes