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 dansdisplayDetails 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.hBibliothèque : xgameruntime.lib
Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series
