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

Obtiene el promedio reciente de la latencia relacionada con el streaming.

## Sintaxis

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

### Parámetros

*client*   \_In\_\
Tipo: XGameStreamingClientId

El dispositivo cliente de streaming cuya latencia se está consultando.

*averageInputLatencyUs*   \_Out\_\
Tipo: uint32\_t\*

La latencia promedio, en microsegundos, durante un período de tiempo reciente para que el juego de XBOX reciba la entrada.

*averageOutputLatencyUs*   \_Out\_\
Tipo: uint32\_t\*

La latencia promedio, en microsegundos, durante un período de tiempo reciente para que un fotograma del juego se represente en el dispositivo cliente.

*standardDeviationUs*   \_Out\_\
Tipo: uint32\_t\*

Promedio observado de la desviación estándar medida de la fluctuación (jitter), en microsegundos, durante un período de tiempo reciente en la latencia.

### Valor devuelto

Tipo: HRESULT

Devuelve **S\_OK** si se realiza correctamente; de lo contrario, devuelve un código de error.

#### Posibles errores

| Código de error                    | Valor de error | Motivo del error                                                                                                                                                                                      |
| ---------------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400     | El entorno de ejecución de XGameStreaming no se ha inicializado. Llame a [XGameStreamingInitialize](/reference/system/xgamestreaming/functions/xgamestreaminginitialize) antes de llamar a otras API. |
| E\_GAMESTREAMING\_NO\_DATA         | 0x89245402     | Los datos solicitados no están disponibles. Es posible que los datos estén disponibles más adelante.                                                                                                  |

Para obtener una lista de códigos de error, consulte [Códigos de error](/reference/errorcodes).

## Comentarios

<Note>No es seguro llamar a esta función en un subproceso con restricciones de tiempo. Para obtener más información, consulte [Subprocesos con restricciones de tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

<Note>Como se explica a continuación, los valores de latencia de entrada y salida miden valores diferentes y pueden calcularse a partir de orígenes diferentes. No se espera que estos valores sean similares y deben tratarse de forma independiente.</Note>

`XGameStreamingGetStreamAddedLatency` proporciona datos sobre la latencia medida debida al streaming del juego. Los juegos pueden utilizar estos datos para comprender mejor la experiencia que el jugador está teniendo con la experiencia transmitida.

Es importante tener en cuenta que esto **no** proporciona la latencia completa de un extremo a otro que un jugador puede notar (por ejemplo, **no** se corresponde directamente con el tiempo transcurrido desde que se presiona un botón en un mando conectado al dispositivo cliente de streaming hasta que se representa un nuevo fotograma que lo tenga en cuenta). Por ejemplo, los siguientes componentes **no** se incluyen en estas mediciones:

* Tiempo de representación del motor del juego
* Tiempo desde que se pasa a representar en el dispositivo cliente hasta que el jugador ve la imagen
* Tiempo de transporte Bluetooth® y de descodificación desde el mando en el dispositivo cliente

En cambio, la latencia de entrada incluye:

* El tiempo que tarda la aplicación de streaming de juegos en procesar las entradas recibidas de un mando.
* El tiempo de transmisión desde la aplicación de streaming de juegos a través de la red hasta el servidor que ejecuta el juego.

La latencia de salida incluye:

* El tiempo de codificación de cada fotograma que representa el título.
* El tiempo de transmisión de este fotograma a través de la red hasta la aplicación con la que interactúa el jugador.
* El tiempo de descodificación en la aplicación, mientras se prepara para presentar el fotograma al jugador.

`XGameStreamingGetStreamAddedLatency` es una medición promedio que se actualiza cada pocos segundos. Para obtener mediciones más precisas, se puede usar la API [XGameStreamingGetAssociatedFrame](/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe). Consulte [Análisis en profundidad de la compensación de latencia en el streaming de juegos](/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive) para obtener más información.

## Requisitos

**Encabezado:** xgamestreaming.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Análisis en profundidad de la compensación de latencia en el streaming de juegos](/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive)
* [Subprocesos con restricciones de tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Consulte también

[XGameStreaming](/reference/system/xgamestreaming/xgamestreaming_members)\
[Información general sobre la compensación de latencia en el streaming de juegos](/build/core-features/common/game-streaming/game-streaming-latency-compensation-overview)


## Related topics

- [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)
- [XGameStreaming](/es/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameStreamingGetAssociatedFrame](/es/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe.md)
- [XGameStreamingGetLastFrameDisplayed](/es/reference/system/xgamestreaming/functions/xgamestreaminggetlastframedisplayed.md)
- [Medición de la latencia en game streaming](/es/build/core-features/common/game-streaming/game-streaming-latency-measurement.md)