> ## 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.

# LampArrayEnumerationKind 열거형

> LampArrayEnumerationKind 열거형

# LampArrayEnumerationKind 열거형

새로 등록된 LampArrayStatusCallback 함수에 대해 원하는 장치 열거 동작을 설명합니다. [RegisterLampArrayStatusCallback](https://docs.xbox.com/ko/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)과 함께 사용되며, 이 동작은 등록 시점에 연결되어 있는 LampArrays에만 적용됩니다.

## 구문

```cpp theme={null}
enum class LampArrayEnumerationKind : uint32_t
{
    Async       = 1,
    Blocking    = 2
};
```

## 상수

| 상수 | 설명 |
| - | - |
| Async | [RegisterLampArrayStatusCallback](https://docs.xbox.com/ko/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md) 호출은 즉시 반환되어야 하며, 연결된 LampArrays의 열거는 전용 LampArray 콜백 워커 스레드에서 비동기로 수행되어야 합니다. |
| Blocking | [RegisterLampArrayStatusCallback](https://docs.xbox.com/ko/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md) 호출은 연결된 모든 LampArrays가 열거될 때까지 블록되어야 합니다. |

## 설명

[RegisterLampArrayStatusCallback](https://docs.xbox.com/ko/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)의 **LampArrayEnumerationKind** 매개변수를 통해 호출자는 호출 시점에 연결된 LampArray 장치에 대한 콜백을 어떻게 수신할지 지정할 수 있습니다. **LampArrayEnumerationKind::Blocking**이 선택된 경우 RegisterLampArrayStatusCallback 함수는 연결된 각 장치에 대해 콜백이 호출될 때까지 블록됩니다. 즉, 콜백은 호출 스레드에서 실행됩니다.

첫 번째 콜백이 등록되면, LampArray API는 **ILampArray** 장치 상태 알림을 처리하기 위한 워커 스레드를 시작합니다. 이러한 이벤트는 자주 발생하지 않으며, 그 외에는 워커 스레드가 대기 상태로 유지됩니다. 등록 호출이 반환된 이후에는 모든 후속 LampArrayStatusCallbacks가 이 워커 스레드에서 순차적으로 호출됩니다.

**LampArrayEnumerationKind::Async**가 지정되면, 등록 호출은 즉시 반환되며, 호출 시점에 연결되어 있는 LampArrays는 앞서 언급한 LampArray 콜백 워커 스레드에서 열거됩니다.

## 요구 사항

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

## 함께 보기

[Lighting API 개요](https://docs.xbox.com/ko/build/core-features/common/lighting/gc-lighting-toc.md)\
[RegisterLampArrayStatusCallback](https://docs.xbox.com/ko/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)


## Related topics

- [LampArrayKind 열거형](https://docs.xbox.com/ko/reference/lighting/lamparray/enums/lamparraykind.md)
- [LampArrayStatus 열거형](https://docs.xbox.com/ko/reference/lighting/lamparray/enums/lamparraystatus.md)
- [LampArray API 멤버](https://docs.xbox.com/ko/reference/lighting/lamparray/lamparray_members.md)
- [LampPurposes 열거형](https://docs.xbox.com/ko/reference/lighting/lamparray/enums/lamppurposes.md)
- [RegisterLampArrayStatusCallback](https://docs.xbox.com/ko/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)