Skip to main content

XGameStreamingGetDisplayDetails

Cette API retourne les détails d’affichage du client spécifié. Ils peuvent servir à 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 diffusion en continu 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é selon largeur / hauteur à partir de 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é selon largeur / hauteur à partir de la résolution la plus haute prise en charge. displayDetails   _Out_
Type : XGameStreamingDisplayDetails*
Détails d’affichage du client de diffusion en continu.

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 essentielles ou l’interface utilisateur pour s’assurer qu’elles restent interactives et ne sont pas masquées. Les valeurs preferredWidth et preferredHeight de la structure displayDetails sont basées sur l’affichage réel du client de diffusion en continu, sur les limitations du système de diffusion en continu et sur les paramètres fournis par le jeu (maxSupportedPixels, widestSupportedAspectRatio, tallestSupportedAspectRatio). Gardez à l’esprit que les données peuvent ne pas être disponibles au démarrage du jeu et qu’elles ne sont pas nécessairement disponibles 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