Skip to main content

XGameStreamingRegisterClientPropertiesChanged

Registra um retorno de chamada a ser invocado quando as propriedades de qualquer dispositivo cliente de streaming forem alteradas.
Após o registro, o retorno de chamada será invocado para as propriedades atuais do dispositivo cliente.

Sintaxe

Parâmetros

client   _In_
Tipo: XGameStreamingClientId
ID do cliente de streaming de jogos para o qual você está se registrando para receber retornos de chamada. 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 um contexto que será passado para a função de retorno de chamada. callback   _In_
Tipo: XGameStreamingClientPropertiesChangedCallback*
A função de retorno de chamada que será invocada quando as propriedades do cliente forem alteradas. 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 permite que o jogo receba um XGameStreamingClientPropertiesChangedCallback sempre que uma XGameStreamingClientProperty, como as dimensões físicas do fluxo, for alterada. O registro FARÁ com que o retorno de chamada seja invocado com todas as XGameStreamingClientProperty aplicáveis, para que seja possível consultar os detalhes atuais das propriedades. Quando o dispositivo cliente de streaming se desconectar, use XGameStreamingUnregisterClientPropertiesChanged para cancelar o registro do retorno de chamada.

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

XGameStreamingClientProperty
XGameStreamingClientPropertiesChangedCallback
XGameStreamingUnregisterClientPropertiesChanged
XGameStreaming
Last modified on October 6, 2026