> ## 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 au streaming.

## 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 streaming pour lequel la latence est interrogée.

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

Latence moyenne, en microsecondes, sur une période récente, nécessaire 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, nécessaire 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/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 pourront l'être ultérieurement. |

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

## Remarques

<Note>Il n'est pas sûr d'appeler cette fonction sur un thread à contrainte de temps. Pour plus d'informations, consultez [Threads à contrainte de 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 grandeurs différentes 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 due au streaming du jeu.  Les jeux peuvent s'en servir pour mieux comprendre l'expérience vécue par le joueur avec le jeu diffusé en streaming.

Il est important de noter que cette fonction ne fournit **pas** la latence complète de bout en bout que le joueur peut percevoir (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 streaming 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 inclut plutôt :

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

La latence de sortie inclut :

* Le temps d'encodage de chaque image rendue par le titre.
* Le temps de transmission de cette image via le réseau jusqu'à l'application avec laquelle le joueur interagit.
* Le temps de décodage dans l'application, lors de la préparation de la présentation de 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/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe) peut être utilisée. Pour plus d'informations, consultez [Présentation détaillée de la compensation de latence du streaming de jeux](/fr/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 détaillée de la compensation de latence du streaming de jeux](/fr/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive)
* [Threads à contrainte de temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

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