Skip to main content

XGameStreamingRegisterConnectionStateChanged

Registra um retorno de chamada a ser invocado quando o estado de conexão de um dispositivo cliente de streaming for alterado. Após o registro, o retorno de chamada será invocado para todos os dispositivos cliente de streaming que já estiverem conectados.

Sintaxe

Parâmetros

queue   _In_opt_
Tipo: XTaskQueueHandle
Identificador da fila assíncrona na qual colocar o retorno de chamada de alteração. context   _In_opt_
Tipo: void*
Um ponteiro opcional para o contexto passado para a função de retorno de chamada. callback   _In_
Tipo: XGameStreamingConnectionStateChangedCallback*
A função de retorno de chamada que será invocada quando o estado de conexão de qualquer dispositivo cliente de streaming for alterado. token   _Out_
Tipo: XTaskQueueRegistrationToken*
Um ponteiro para o token de registro que pode ser usado para cancelar o registro do evento.

Valor retornado

Tipo: HRESULT Retornará S_OK se for bem-sucedido; caso contrário, retornará um código de erro.

Erros potenciais

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.
Esta API é a forma recomendada de fazer com que o jogo realize personalizações por dispositivo cliente de streaming e mantenha um estado que permita otimizar a experiência com base na existência de dispositivos conectados.
Após o registro, o retorno de chamada será invocado para todos os dispositivos cliente de streaming conectados no momento.

Exemplo

Requisitos

Cabeçalho: xgamestreaming.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XGameStreamingConnectionState
XGameStreamingConnectionStateChangedCallback
XGameStreamingUnregisterConnectionStateChanged
XGameStreaming
Last modified on October 6, 2026