Skip to main content

Lighting API 참고 자료

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

호환되는 주변 장치 열거

호환되는 주변 장치를 검색하려면, 각 연결된 장치에 대해 그리고 장치가 연결되거나 제거될 때마다 LampArray API가 호출하는 상태 콜백을 등록합니다.
  1. 장치의 연결 및 연결 해제 이벤트를 수신할 LampArrayStatusCallback 함수를 구현합니다.
  2. RegisterLampArrayStatusCallback을 호출하여 콜백을 등록합니다. 초기 열거를 비동기로 실행할지 아니면 연결된 모든 장치를 보고할 때까지 블록할지를 제어하려면 LampArrayEnumerationKind 값을 전달합니다.
  3. 콜백에서 ILampArray 인스턴스를 검사하여 DeviceId, LampArrayKind, LampCount, VendorId, ProductId와 같은 장치 속성을 읽습니다.
  4. 알림이 더 이상 필요하지 않으면 UnregisterLampArrayStatusCallback을 호출하여 이벤트 수신을 중지합니다.
샘플 코드와 함께 자세한 안내를 보려면 LampArray 기본 사항을 참조하세요.

이 섹션의 내용

LampArray
LampArray API 멤버로, 장치를 열거하고 조명을 제어하는 데 사용되는 함수, 인터페이스, 열거형 및 구조체를 포함합니다.

함께 보기

Lighting API 개요
마지막 수정일 2026년 8월 7일