> ## 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 열거형

> LampPurposes 열거형

# 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 | 사용자가 직접 바라보는 Lamp입니다(예: 예술 작품이나 의상 내부).                                   |

<a id="remarksSection" />

## 설명

이 목록은 앞으로 확장될 가능성이 높으므로, LampPurpose가 현재 범위 내에 있는지 검증하는 오류 검사를 두지 않도록 하세요. 애플리케이션이 지원하는 LampPurposes의 부분 집합과 비교하는 방식이 권장됩니다.

<a id="requirementsSection" />

## 요구 사항

**헤더:** LampArray.h에 선언되어 있습니다.

<a id="seealsoSection" />

## 함께 보기

[Lighting API 개요](/build/core-features/common/lighting/gc-lighting-toc)\
[ILampArray::GetIndicesCountForPurposes](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes)\
[ILampArray::GetIndicesForPurposes](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes)\
[ILampInfo::GetPurposes](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes)


## Related topics

- [LampArray](/ko/reference/lighting/lamparray/lamparray_members.md)
- [LampArrayKind 열거형](/ko/reference/lighting/lamparray/enums/lamparraykind.md)
- [LampArrayStatus 열거형](/ko/reference/lighting/lamparray/enums/lamparraystatus.md)
- [LampArrayEnumerationKind 열거형](/ko/reference/lighting/lamparray/enums/lamparrayenumerationkind.md)
- [ILampArray::GetIndicesForPurposes](/ko/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes.md)