XGameStreamingGetStreamAddedLatency
Obtiene el promedio reciente de la latencia relacionada con el streaming.Sintaxis
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
Para obtener una lista de códigos de error, consulte Códigos de error.
Comentarios
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.
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.
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
- 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.
- 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. Consulte Análisis en profundidad de la compensación de latencia en el streaming de juegos 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 SeriesDocumentación conceptual
- Análisis en profundidad de la compensación de latencia en el streaming de juegos
- Subprocesos con restricciones de tiempo
Consulte también
XGameStreamingInformación general sobre la compensación de latencia en el streaming de juegos