Skip to main content

XGameStreamingGetDisplayDetails

Cette API retourne les détails d’affichage du client spécifié. Ces informations permettent de prendre des décisions éclairées, par exemple sur les rapports d’aspect personnalisés à utiliser pour le rendu ou sur la résolution à utiliser pour activer DirectCapture.

Syntaxe

Paramètres

client   _In_
Type : XGameStreamingClientId
Client de streaming interrogé. maxSupportedPixels   _In_
Type : uint32_t
Nombre maximal de pixels pris en charge par le jeu. widestSupportedAspectRatio   _In_
Type : float
Rapport d’aspect le plus large pris en charge par le jeu. Il est calculé à partir de largeur / hauteur en utilisant la résolution la plus large prise en charge. tallestSupportedAspectRatio   _In_
Type : float
Rapport d’aspect le plus haut pris en charge par le jeu. Il est calculé à partir de largeur / hauteur en utilisant la résolution la plus haute prise en charge. displayDetails   _Out_
Type : XGameStreamingDisplayDetails*
Détails d’affichage du client de streaming.

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

Les données contenues dans displayDetails peuvent servir à piloter certains aspects du jeu, comme la résolution de rendu du jeu, et à déterminer où placer les informations ou l’interface utilisateur essentielles afin qu’elles restent interactives et ne soient pas masquées. Les valeurs preferredWidth et preferredHeight de la structure displayDetails sont basées sur l’affichage réel du client de streaming, sur les limitations du système de streaming et sur les paramètres fournis par le jeu (maxSupportedPixels, widestSupportedAspectRatio, tallestSupportedAspectRatio). N’oubliez pas que les données peuvent ne pas être disponibles au démarrage du jeu, ni nécessairement au moment de l’événement de connexion du client ; les jeux doivent donc utiliser des événements ou l’interrogation.

Exemple

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

Voir aussi

XGameStreaming XGameStreamingDisplayDetails XGameStreamingRegisterClientPropertiesChanged XGameStreamingSetResolution Vue d’ensemble de la résolution personnalisée
Last modified on October 6, 2026