Skip to main content

XGameActivationRegisterForEvent

注册激活事件的回调。

Syntax

Parameters

queue   _In_opt_
类型:XTaskQueueHandle
用于调度事件回调的任务队列。 context   _In_opt_
类型:void*
传递给事件回调的上下文。 callback   _In_
类型:XGameActivationCallback*
事件回调函数。 token   _Out_
类型:XTaskQueueRegistrationToken*
来自任务队列的令牌,表示此次注册。使用该令牌取消注册激活事件的回调。

Return value

类型:HRESULT HRESULT 成功或错误代码。 有关错误代码的列表,请参阅错误代码

Remarks

此函数在时间敏感型线程上调用是不安全的。有关详细信息,请参阅时间敏感型线程
XGameActivationRegisterForEvent 函数使用 XGameActivationCallback 作为参数。回调接收包含激活类型和相应数据的 XGameActivationInfo 结构。 此 API 处理所有激活类型,包括协议激活、文件激活和游戏邀请。它替代了已弃用的 XGameProtocolRegisterForActivationXGameInviteRegisterForEvent API。 若要取消注册激活事件的回调,请调用 XGameActivationUnregisterForEvent 有关调用此函数的示例,请参阅 XGameActivationCallback 主题的“备注”部分。

Requirements

头文件: XGameActivation.h 库: xgameruntime.lib 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

Conceptual documentation

See also

XGameActivation XGameActivationCallback XGameActivationUnregisterForEvent
最后修改于 2026年8月24日