Skip to main content

XGameStreamingSetResolution

Définit la résolution de la diffusion en continu.

Syntaxe

Paramètres

width   _In_
Type : uint32_t
Largeur à appliquer à la résolution de la diffusion en continu. height   _In_
Type : uint32_t
Hauteur à appliquer à la résolution de la 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

Avec des résolutions non standard, cette API ne réussira que sur les serveurs XBOX Game Streaming, la XBOX Series X Dev Kit et la XBOX Series S Test Kit. Les résolutions standard comme 720p et 1080p réussiront quel que soit le matériel. La raison est qu’une XBOX commerciale ne peut diffuser en continu que par la lecture à distance (Remote Play) et peut encore transmettre la vidéo au téléviseur; l’utilisation d’une résolution non standard produirait donc une image déformée. La largeur et la hauteur doivent être d’au moins 640x360, et le maximum se trouve dans les champs maxWidth et maxHeight de la structure XGameStreamingDisplayDetails, qui peut être obtenue à 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 pourrait être augmentée à l’avenir. Les valeurs width et height doivent être divisibles par 8. L’API peut être appelée aussi souvent que souhaité, mais la résolution de la diffusion en continu 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 de la diffusion en continu pour tous les clients connectés. Il faut donc porter une attention particulière pour déterminer la meilleure option pour le jeu lorsque plusieurs clients sont connectés. Cela peut signifier utiliser une résolution standard 16:9 ou tenter de trouver la résolution qui convient le mieux à tous les clients.
La modification de la résolution de la diffusion en continu 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 de 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