Skip to main content

​
XGameStreamingGetStreamAddedLatency

Obtém a média recente da latência relacionada ao streaming.

​
Sintaxe

​
Parâmetros

client   _In_
Tipo: XGameStreamingClientId O dispositivo cliente de streaming para o qual a latência está sendo consultada. averageInputLatencyUs   _Out_
Tipo: uint32_t* A latência média, em microssegundos, durante um período recente, para que a entrada seja recebida pelo jogo XBOX. averageOutputLatencyUs   _Out_
Tipo: uint32_t* A latência média, em microssegundos, durante um período recente, para que um quadro do jogo seja renderizado no dispositivo cliente. standardDeviationUs   _Out_
Tipo: uint32_t* Média observada do desvio padrão medido da variação (jitter) da latência, em microssegundos, durante um período recente.

​
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.
Conforme explicado abaixo, os valores de latência de entrada e de saída medem valores diferentes e podem ser calculados a partir de fontes diferentes. Não se espera que esses valores sejam semelhantes, e eles devem ser tratados de forma independente.
XGameStreamingGetStreamAddedLatency fornece dados sobre a latência medida decorrente do streaming do jogo. Isso pode ser utilizado pelos jogos para entender melhor a experiência que o jogador está tendo com o streaming. É importante observar que isso não fornece a latência completa de ponta a ponta que um jogador pode perceber (por exemplo, não corresponde diretamente ao tempo desde o pressionamento de um botão em um controle conectado ao dispositivo cliente de streaming até que um novo quadro que leve isso em conta seja renderizado.) Por exemplo, os seguintes componentes não estão incluídos nessas medições:
  • Tempo de renderização do mecanismo do jogo
  • Tempo desde o envio para renderização no dispositivo cliente até o momento em que o jogador vê a imagem
  • Tempo de transporte e decodificação Bluetooth® do controle no dispositivo cliente
Em vez disso, a latência de entrada inclui:
  • O tempo que o aplicativo de streaming de jogos leva para processar as entradas recebidas de um controle.
  • O tempo de transmissão do aplicativo de streaming de jogos pela rede até o servidor que está executando o jogo.
A latência de saída inclui:
  • O tempo de codificação de cada quadro renderizado pelo título.
  • O tempo para transmitir esse quadro pela rede até o aplicativo com o qual o jogador está interagindo.
  • O tempo de decodificação no aplicativo, enquanto ele se prepara para apresentar o quadro ao jogador.
XGameStreamingGetStreamAddedLatency é uma medição média atualizada a cada poucos segundos. Para medições mais precisas, a API XGameStreamingGetAssociatedFrame pode ser usada. Consulte Análise detalhada da compensação de latência do streaming de jogos para obter mais informações.

​
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

XGameStreaming
Visão geral da compensação de latência do streaming de jogos
Last modified on October 6, 2026