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 champsmaxWidth 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.hBibliothèque : xgameruntime.lib
Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series
Voir aussi
XGameStreamingXGameStreamingDisplayDetails
XGameStreamingGetDisplayDetails
Vue d’ensemble de la résolution personnalisée
