Skip to main content

​
XGameActivationRegisterForEvent

註冊啟用事件的回呼。

​
語法

​
參數

queue   _In_opt_
類型：XTaskQueueHandle 分派事件回呼的工作佇列。 context   _In_opt_
類型：void* 傳遞給事件回呼的內容。 callback   _In_
類型：XGameActivationCallback* 事件回呼函式。 token   _Out_
類型：XTaskQueueRegistrationToken* 來自工作佇列、代表此註冊的權杖。使用此權杖可取消註冊啟用事件的回呼。

​
傳回值

類型：HRESULT HRESULT 成功或錯誤碼。
如需錯誤碼清單，請參閱錯誤碼。

​
備註

在時間敏感的執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱時間敏感的執行緒。
XGameActivationRegisterForEvent 函式會使用 XGameActivationCallback 作為引數。回呼會收到包含啟用類型和對應資料的 XGameActivationInfo 結構。 此 API 會處理所有啟用類型，包括通訊協定啟用、檔案啟用和遊戲邀請。它取代了已淘汰的 XGameProtocolRegisterForActivation 和 XGameInviteRegisterForEvent API。 若要取消註冊啟用事件的回呼，請呼叫 XGameActivationUnregisterForEvent。 如需呼叫此函式的範例，請參閱 XGameActivationCallback 主題的備註一節。

​
需求

標頭： XGameActivation.h 程式庫： xgameruntime.lib 支援的平台： Windows、XBOX One 系列主機和 XBOX Series 主機

​
概念文件

​
另請參閱

XGameActivation XGameActivationCallback XGameActivationUnregisterForEvent
Last modified on October 6, 2026