> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LampPurposes 列舉參考

> 描述單一 Lamp 預定用途的旗標列舉，例如 Control、Accent、Branding、Status、Illumination 和 Presentation。

# LampPurposes 列舉

描述單一 Lamp 預定用於的一組用途。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
enum class LampPurposes : uint32_t
{
    Undefined       = 0x00,
    Control         = 0x01,
    Accent          = 0x02,
    Branding        = 0x04,
    Status          = 0x08,
    Illumination    = 0x10,
    Presentation    = 0x20
}; 

DEFINE_ENUM_FLAG_OPERATORS(LampPurposes);
```

<a id="constantsSection" />

## 常數

| 常數 | 描述 |
| - | - |
| Undefined | 未針對此 Lamp 指定 LampPurposes。 |
| Control | Lamp 與裝置上的控制項相關聯 (例如按鈕、按鍵、滑桿)。 |
| Accent | Lamp 用於美觀點綴用途，且不會與使用者互動 (例如機殼風扇 LED、鍵盤上的發光側板)。 |
| Branding | Lamp 用於裝置品牌標示 (例如製造商標誌)。 |
| Status | Lamp 用於指示系統狀態資訊 (例如未讀取的電子郵件、CPU 溫度)。 |
| Illumination | Lamp 照亮 LampArray 外部的物體 (例如舞台聚光燈、汽車頭燈、相機閃光燈)。 |
| Presentation | 使用者直接觀看的燈 (例如在藝術品或服裝內)。 |

<a id="remarksSection" />

## 備註

此清單未來可能會擴充，因此請避免使用驗證 LampPurpose 是否在目前範圍內的錯誤檢查。建議的做法是與應用程式支援的 LampPurposes 子集進行比較。

<a id="requirementsSection" />

## 需求

**標頭：** 在 LampArray.h 中宣告。

<a id="seealsoSection" />

## 另請參閱

[照明 API 概觀](/zh-TW/build/core-features/common/lighting/gc-lighting-toc)\
[ILampArray::GetIndicesCountForPurposes](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes)\
[ILampArray::GetIndicesForPurposes](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes)\
[ILampInfo::GetPurposes](/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes)


## Related topics

- [LampPurposes 枚举](/zh-CN/reference/lighting/lamparray/enums/lamppurposes.md)
- [LampPurposes 列挙型](/ja-jp/reference/lighting/lamparray/enums/lamppurposes.md)
- [LampPurposes 열거형](/ko/reference/lighting/lamparray/enums/lamppurposes.md)
- [LampPurposes enum reference](/reference/lighting/lamparray/enums/lamppurposes.md)
- [Referencia de la enumeración LampPurposes](/es/reference/lighting/lamparray/enums/lamppurposes.md)