Skip to main content

XGameStreamingSetResolution

Définit la résolution du stream.

Syntaxe

Paramètres

width   _In_
Type : uint32_t
Largeur à appliquer à la résolution du stream. height   _In_
Type : uint32_t
Hauteur à appliquer à la résolution du stream.

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

Avec des résolutions non standard, cette API ne réussit que sur les serveurs XBOX Game Streaming, le XBOX Series X Dev Kit et le XBOX Series S Test Kit. Les résolutions standard telles que 720p et 1080p réussissent quel que soit le matériel. En effet, une XBOX commerciale ne peut diffuser en streaming que via Remote Play et peut encore envoyer la vidéo vers le téléviseur ; l’utilisation d’une résolution non standard produirait alors une image déformée. La largeur et la hauteur doivent être d’au moins 640x360, et le maximum figure dans les champs maxWidth et maxHeight de XGameStreamingDisplayDetails, qui peut être obtenu à partir de XGameStreamingGetDisplayDetails. Le nombre maximal de pixels, calculé à partir de width * height, doit être inférieur ou égal au maximum de l’encodeur. Ce maximum peut être obtenu à l’aide de l’API XGameStreamingGetDisplayDetails. Cette valeur pourra être augmentée à l’avenir. width et height doivent être divisibles par 8. L’API peut être appelée aussi souvent que souhaité, mais la résolution du stream ne peut changer qu’une fois toutes les 200 ms. La dernière résolution parmi les appels effectués dans cette fenêtre de 200 ms sera appliquée une fois la fenêtre écoulée. Sachez que cette API définit la résolution du stream pour tous les clients connectés. Il convient donc de bien réfléchir à la meilleure option pour le jeu lorsque plusieurs clients sont connectés. Cela peut impliquer d’utiliser une résolution standard 16:9 ou d’essayer de trouver la résolution la mieux adaptée à tous les clients.
La modification de la résolution du stream modifie la mise à l’échelle du rectangle d’affichage dans ID3D12CommandQueue::PresentX. Les facteurs d’échelle de 0,0 à 1,0 de D3D12XBOX_PRESENT_PLANE_PARAMETERS.pDestPlacementBase se rapportent à la hauteur et à la largeur passées à XGameStreamingSetResolution, plutôt qu’à la résolution standard 1920x1080 ou 3840x2160 à laquelle ils se rapporteraient autrement.

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
XGameStreamingGetDisplayDetails
Vue d’ensemble de la résolution personnalisée
Last modified on October 6, 2026