XGameStreamingGetStreamAddedLatency
Obtient la moyenne récente de la latence liée au streaming.Syntaxe
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
Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.
Remarques
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.
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.
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
- 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.
- 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 peut être utilisée. Pour plus d’informations, consultez Présentation détaillée de la compensation de latence du streaming de jeux.
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 SeriesDocumentation conceptuelle
- Présentation détaillée de la compensation de latence du streaming de jeux
- Threads à contrainte de temps
Voir aussi
XGameStreamingVue d’ensemble de la compensation de latence du streaming de jeux