Skip to main content

RegisterLampArrayCallback

註冊每當 LampArray 連線到系統或從系統中斷連線時要叫用的回呼函式。

語法

參數

lampArrayCallback   _In_ 類型:LampArrayCallback 要註冊的呼叫端定義函式。當 LampArray 連線到系統或從系統中斷連線時,將會叫用此函式。 context   _In_opt_
類型:void*
指向物件的指標,該物件包含回呼函式的相關資訊。這通常是呼叫物件。 callbackToken   _Out_ _Result_zeroonfailure_ 類型:LampArrayCallbackToken* 可用於稍後取消註冊回呼函式的權杖值。

傳回值

類型:HRESULT 函式結果。

備註

如果在註冊回呼時已連接任何 LampArray 裝置,RegisterLampArrayCallback 函式將會封鎖,直到針對每個已連接的裝置叫用該回呼為止 (表示回呼將在呼叫執行緒上叫用)。 註冊第一個回呼時,LampArray API 會啟動背景工作執行緒來處理 ILampArray 裝置連接和移除通知。這些事件並不頻繁,背景工作執行緒在其他時間會維持在等候狀態。註冊呼叫傳回之後,所有後續的 LampArrayCallback 都會在此背景工作執行緒上依序叫用。 下列程式碼是註冊和取消註冊 LampArray 回呼的範例:

需求

標頭: LampArray.h 程式庫: xgameplatform.lib 支援的平台: XBOX One 系列主機和 XBOX Series 主機

另請參閱

照明 API 概觀
照明基本概念
LampArrayCallback
UnregisterLampArrayCallback
Last modified on October 6, 2026