> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameStreamingGetStreamAddedLatency

> XGameStreamingGetStreamAddedLatency

# XGameStreamingGetStreamAddedLatency

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

## Sintaxe

```cpp theme={null}
HRESULT XGameStreamingGetStreamAddedLatency(  
         XGameStreamingClientId client,  
         uint32_t* averageInputLatencyUs,  
         uint32_t* averageOutputLatencyUs,  
         uint32_t* standardDeviationUs  
)  
```

### 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

| Código de erro | Valor do erro | Motivo do erro |
| - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | O runtime do XGameStreaming não foi inicializado. Chame [XGameStreamingInitialize](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminginitialize) antes de chamar outras APIs. |
| E\_GAMESTREAMING\_NO\_DATA | 0x89245402 | Os dados solicitados não estão disponíveis. Os dados podem ficar disponíveis mais tarde. |

Para obter uma lista de códigos de erro, consulte [Códigos de erro](/pt-BR/reference/errorcodes).

## Comentários

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

<Note>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.</Note>

`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](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe) pode ser usada. Consulte [Análise detalhada da compensação de latência do streaming de jogos](/pt-BR/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive) 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

* [Análise detalhada da compensação de latência do streaming de jogos](/pt-BR/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive)
* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[XGameStreaming](/pt-BR/reference/system/xgamestreaming/xgamestreaming_members)\
[Visão geral da compensação de latência do streaming de jogos](/pt-BR/build/core-features/common/game-streaming/game-streaming-latency-compensation-overview)


## Related topics

- [XGameStreamingGetStreamAddedLatency](/reference/system/xgamestreaming/functions/xgamestreaminggetstreamaddedlatency.md)
- [Game streaming latency compensation deep dive](/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive.md)
- [XGameStreaming](/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameStreamingGetAssociatedFrame](/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe.md)
- [Análisis en profundidad de la compensación de latencia en game streaming](/es/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive.md)