Pular para o conteúdo principal

XGameInviteRegisterForEvent (preterido)

Esta API agora está preterida. Use XGameActivationRegisterForEvent em vez disso.
Registra um retorno de chamada para um evento de convite de jogo.

Sintaxe

Parâmetros

queue   _In_opt_
Tipo: XTaskQueueHandle
A fila de tarefas que despacha o retorno de chamada do evento. context   _In_opt_
Tipo: void*
O contexto que passamos para o retorno de chamada do evento. callback   _In_
Tipo: XGameInviteEventCallback*
A função de retorno de chamada do evento. token   _Out_
Tipo: XTaskQueueRegistrationToken*
Um token da fila de tarefas que representa o registro. Use o token para cancelar o registro do retorno de chamada para o evento de convite de jogo.

Valor retornado

Tipo: HRESULT Código de êxito ou de erro HRESULT.
Para obter uma lista de códigos de erro, consulte Códigos de erro.

Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
A função XGameInviteRegisterForEvent usa um XGameInviteEventCallBack como argumento. Para cancelar o registro de um retorno de chamada para um evento de convite de jogo, chame XGameInviteUnregisterForEvent. Para obter um exemplo de como chamar esta função, consulte a seção de comentários do tópico XGameInviteEventCallback.

Requisitos

Cabeçalho: XGameInvite.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XGameInvite XGameInviteEventCallBack XGameInviteUnregisterForEvent
Última modificação em 19 de outubro de 2026