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

# LampPurposes 열거형

> LampPurposes 열거형

# LampPurposes 열거형

단일 Lamp가 사용되도록 의도된 목적의 집합을 설명합니다.

## 구문

```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);
```

## 상수

| 상수 | 설명 |
| - | - |
| Undefined | 이 Lamp에는 LampPurposes가 지정되어 있지 않습니다. |
| Control | Lamp가 장치의 컨트롤(예: 버튼, 키, 슬라이더)과 연결되어 있습니다. |
| Accent | Lamp가 심미적 강조 목적으로 사용되며 사용자와 상호작용하지 않습니다(예: 케이스 팬 LED, 키보드의 조명이 있는 측면 패널). |
| Branding | Lamp가 장치 브랜딩(예: 제조업체 로고)에 사용됩니다. |
| Status | Lamp가 시스템 상태 정보(예: 읽지 않은 이메일, CPU 온도)를 표시하는 데 사용됩니다. |
| Illumination | Lamp가 LampArray 외부의 개체를 비춥니다(예: 무대 스포트라이트, 자동차 헤드라이트, 카메라 플래시). |
| Presentation | 사용자가 직접 바라보는 Lamp입니다(예: 예술 작품이나 의상 내부). |

## 설명

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

## 요구 사항

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

## 함께 보기

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


## Related topics

- [LampArray API 멤버](https://docs.xbox.com/ko/reference/lighting/lamparray/lamparray_members.md)
- [LampArrayKind 열거형](https://docs.xbox.com/ko/reference/lighting/lamparray/enums/lamparraykind.md)
- [LampArrayStatus 열거형](https://docs.xbox.com/ko/reference/lighting/lamparray/enums/lamparraystatus.md)
- [LampArrayEnumerationKind 열거형](https://docs.xbox.com/ko/reference/lighting/lamparray/enums/lamparrayenumerationkind.md)
- [GetIndicesForPurposes](https://docs.xbox.com/ko/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes.md)