Skip to main content

燈光 API 參考

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

列舉相容的周邊裝置

若要探索相容的周邊裝置,請註冊狀態回呼,LampArray API 會針對每個已連接的裝置叫用此回呼,並在每次連接或移除裝置時再次叫用。
  1. 實作 LampArrayStatusCallback 函式以接收裝置連接和中斷連接事件。
  2. 呼叫 RegisterLampArrayStatusCallback 以註冊回呼。傳遞 LampArrayEnumerationKind 值,以控制初始列舉要以非同步方式執行,還是封鎖直到所有已連接的裝置都已回報為止。
  3. 在回呼中,檢查 ILampArray 執行個體以讀取裝置屬性,例如 DeviceId、LampArrayKind、LampCount、VendorId 和 ProductId。
  4. 當您不再需要通知時,請呼叫 UnregisterLampArrayCallback 以停止接收事件。
如需包含範例程式碼的完整逐步解說,請參閱 LampArray 基本概念。

本節內容

LampArray
LampArray API 成員,包括用於列舉裝置和控制燈光的函式、介面、列舉和結構。

另請參閱

燈光 API 概觀
Last modified on October 6, 2026