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