Skip to main content

XGameActivationRegisterForEvent

Registra una devolución de llamada para los eventos de activación.

Sintaxis

Parámetros

queue   _In_opt_
Tipo: XTaskQueueHandle
La cola de tareas que distribuye la devolución de llamada del evento. context   _In_opt_
Tipo: void*
El contexto pasado a la devolución de llamada del evento. callback   _In_
Tipo: XGameActivationCallback*
La función de devolución de llamada del evento. token   _Out_
Tipo: XTaskQueueRegistrationToken*
Un token de la cola de tareas que representa el registro. Use el token para anular el registro de la devolución de llamada para los eventos de activación.

Valor devuelto

Tipo: HRESULT Código HRESULT de éxito o de error.
Para obtener una lista de códigos de error, consulte Códigos de error.

Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
La función XGameActivationRegisterForEvent usa una XGameActivationCallback como argumento. La devolución de llamada recibe una estructura XGameActivationInfo que contiene el tipo de activación y los datos correspondientes. Esta API controla todos los tipos de activación, incluida la activación de protocolo, la activación de archivos y las invitaciones de juego. Reemplaza a las API en desuso XGameProtocolRegisterForActivation y XGameInviteRegisterForEvent. Para anular el registro de una devolución de llamada para los eventos de activación, llame a XGameActivationUnregisterForEvent. Para ver un ejemplo de llamada a esta función, consulte la sección de comentarios del tema XGameActivationCallback.

Requisitos

Encabezado: XGameActivation.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XGameActivation XGameActivationCallback XGameActivationUnregisterForEvent
Última modificación el 28 de agosto de 2026