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

# LampArray 周邊裝置的燈光 API 參考

> GDK 燈光 API 參考，用於列舉鍵盤、滑鼠和耳機等 LampArray 周邊裝置，並控制其 RGB 燈光。

# 燈光 API 參考

Microsoft Game Development Kit (GDK) 的燈光 API 參考資料。使用這些 API 來列舉相容的 LampArray 周邊裝置 (鍵盤、滑鼠、耳機和其他 HID 燈光裝置)，並控制其 RGB 燈光。

## 列舉相容的周邊裝置

若要探索相容的周邊裝置，請註冊狀態回呼，LampArray API 會針對每個已連接的裝置叫用此回呼，並在每次連接或移除裝置時再次叫用。

1. 實作 [LampArrayStatusCallback](/zh-TW/reference/lighting/lamparray/functions/lamparraystatuscallback) 函式以接收裝置連接和中斷連接事件。
2. 呼叫 [RegisterLampArrayStatusCallback](/zh-TW/reference/lighting/lamparray/functions/registerlamparraystatuscallback) 以註冊回呼。傳遞 [LampArrayEnumerationKind](/zh-TW/reference/lighting/lamparray/enums/lamparrayenumerationkind) 值，以控制初始列舉要以非同步方式執行，還是封鎖直到所有已連接的裝置都已回報為止。
3. 在回呼中，檢查 [ILampArray](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/ilamparray) 執行個體以讀取裝置屬性，例如 [DeviceId](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getdeviceid)、[LampArrayKind](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind)、[LampCount](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampcount)、[VendorId](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getvendorid) 和 [ProductId](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getproductid)。
4. 當您不再需要通知時，請呼叫 [UnregisterLampArrayCallback](/zh-TW/reference/lighting/lamparray/functions/unregisterlamparraycallback) 以停止接收事件。

如需包含範例程式碼的完整逐步解說，請參閱 [LampArray 基本概念](/zh-TW/build/core-features/common/lighting/lighting-basics)。

## 本節內容

[LampArray](/zh-TW/reference/lighting/lamparray/lamparray_members)<br />LampArray API 成員，包括用於列舉裝置和控制燈光的函式、介面、列舉和結構。

## 另請參閱

[燈光 API 概觀](/zh-TW/build/core-features/common/lighting/gc-lighting-toc)


## Related topics

- [XBOX 遊戲的 XBOX 需求](/zh-TW/publishing/certification/xbox-requirements.md)
- [LampArray 效果](/zh-CN/build/core-features/common/lighting/lighting-effects.md)
- [ILampInfo](/zh-CN/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)
- [LampArray](/ko/reference/lighting/lamparray/lamparray_members.md)
- [ILampArray::SetColor](/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolor.md)