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

Obtient la moyenne récente de la latence liée à la diffusion en continu.

## Syntaxe

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

### Paramètres

*client*   \_In\_\
Type : XGameStreamingClientId

Appareil client de diffusion en continu pour lequel la latence est interrogée.

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

Latence moyenne, en microsecondes, sur une période récente, pour que l'entrée soit reçue par le jeu XBOX.

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

Latence moyenne, en microsecondes, sur une période récente, pour qu'une image du jeu soit rendue sur l'appareil client.

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

Moyenne observée de l'écart-type mesuré de la gigue de la latence, en microsecondes, sur une période récente.

### Valeur de retour

Type : HRESULT

Retourne **S\_OK** en cas de réussite; sinon, retourne un code d'erreur.

#### Erreurs potentielles

| Code d'erreur | Valeur d'erreur | Cause de l'erreur |
| - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | Le runtime XGameStreaming n'a pas été initialisé. Appelez [XGameStreamingInitialize](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminginitialize) avant d'appeler d'autres API. |
| E\_GAMESTREAMING\_NO\_DATA | 0x89245402 | Les données demandées ne sont pas disponibles. Elles pourraient l'être plus tard. |

Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr-CA/reference/errorcodes).

## Remarques

<Note>Cette fonction ne peut pas être appelée de façon sécuritaire sur un thread sensible au temps. Pour plus d'informations, consultez [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

<Note>Comme expliqué ci-dessous, les valeurs de latence d'entrée et de sortie mesurent des éléments différents et peuvent être calculées à partir de sources différentes. Ces valeurs ne sont pas censées être similaires et doivent être traitées indépendamment.</Note>

`XGameStreamingGetStreamAddedLatency` fournit des données sur la latence mesurée attribuable à la diffusion en continu du jeu. Les jeux peuvent les utiliser pour mieux comprendre l'expérience que vit le joueur avec la diffusion en continu.

Il est important de noter que cette fonction ne fournit **pas** la latence complète de bout en bout que peut remarquer un joueur (par exemple, elle ne correspond **pas** directement au délai entre l'appui sur un bouton d'une manette connectée à l'appareil client de diffusion en continu et le rendu d'une nouvelle image qui en tient compte). Par exemple, les composants suivants ne sont **pas** inclus dans ces mesures :

* Temps de rendu du moteur de jeu
* Temps écoulé entre la transmission pour le rendu sur l'appareil client et le moment où le joueur voit l'image
* Temps de transport et de décodage Bluetooth® depuis la manette sur l'appareil client

La latence d'entrée comprend plutôt :

* Le temps nécessaire à l'application de diffusion de jeux en continu pour traiter les entrées reçues d'une manette.
* Le temps de transmission de l'application de diffusion de jeux en continu, sur le réseau, jusqu'au serveur qui exécute le jeu.

La latence de sortie comprend :

* Le temps d'encodage de chaque image rendue par le titre.
* Le temps de transmission de cette image sur le réseau jusqu'à l'application avec laquelle le joueur interagit.
* Le temps de décodage dans l'application, pendant qu'elle se prépare à présenter l'image au joueur.

`XGameStreamingGetStreamAddedLatency` est une mesure moyenne mise à jour toutes les quelques secondes. Pour des mesures plus précises, l'API [XGameStreamingGetAssociatedFrame](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe) peut être utilisée. Pour plus d'informations, consultez [Présentation approfondie de la compensation de latence pour la diffusion de jeux en continu](/fr-CA/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive).

## Configuration requise

**En-tête :** xgamestreaming.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Présentation approfondie de la compensation de latence pour la diffusion de jeux en continu](/fr-CA/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive)
* [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[XGameStreaming](/fr-CA/reference/system/xgamestreaming/xgamestreaming_members)\
[Vue d'ensemble de la compensation de latence pour la diffusion de jeux en continu](/fr-CA/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)