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

# Lighting API 참고 자료

> Lighting API 참고 자료

# Lighting API 참고 자료

Microsoft Game Development Kit(GDK)의 Lighting API 참고 자료입니다. 이러한 API를 사용하여 호환되는 LampArray 주변 장치(키보드, 마우스, 헤드셋 및 기타 HID 조명 장치)를 열거하고 해당 장치의 RGB 조명을 제어할 수 있습니다.

## 호환되는 주변 장치 열거

호환되는 주변 장치를 검색하려면, 각 연결된 장치에 대해 그리고 장치가 연결되거나 제거될 때마다 LampArray API가 호출하는 상태 콜백을 등록합니다.

1. 장치의 연결 및 연결 해제 이벤트를 수신할 [LampArrayStatusCallback](/reference/lighting/lamparray/functions/lamparraystatuscallback) 함수를 구현합니다.
2. [RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback)을 호출하여 콜백을 등록합니다. 초기 열거를 비동기로 실행할지 아니면 연결된 모든 장치를 보고할 때까지 블록할지를 제어하려면 [LampArrayEnumerationKind](/reference/lighting/lamparray/enums/lamparrayenumerationkind) 값을 전달합니다.
3. 콜백에서 [ILampArray](/reference/lighting/lamparray/interfaces/ilamparray/ilamparray) 인스턴스를 검사하여 [DeviceId](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getdeviceid), [LampArrayKind](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind), [LampCount](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampcount), [VendorId](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getvendorid), [ProductId](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getproductid)와 같은 장치 속성을 읽습니다.
4. 알림이 더 이상 필요하지 않으면 [UnregisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/unregisterlamparraycallback)을 호출하여 이벤트 수신을 중지합니다.

샘플 코드와 함께 자세한 안내를 보려면 [LampArray 기본 사항](/build/core-features/common/lighting/lighting-basics)을 참조하세요.

## 이 섹션의 내용

[LampArray](/reference/lighting/lamparray/lamparray_members)<br />LampArray API 멤버로, 장치를 열거하고 조명을 제어하는 데 사용되는 함수, 인터페이스, 열거형 및 구조체를 포함합니다.

## 함께 보기

[Lighting API 개요](/build/core-features/common/lighting/gc-lighting-toc)