DXGI_SWAP_CHAIN_FLAG (consoles XBOX Series)

Options de comportement de la chaîne d’échange.

Syntaxe

typedef enum DXGI_SWAP_CHAIN_FLAG    
{  
    DXGI_SWAP_CHAIN_FLAG_NONPREROTATED = 1,  
    DXGI_SWAP_CHAIN_FLAG_ALLOW_MODE_SWITCH = 2,  
    DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLE = 4,  
    DXGI_SWAP_CHAIN_FLAG_RESTRICTED_CONTENT = 8,  
    DXGI_SWAP_CHAIN_FLAG_RESTRICT_SHARED_RESOURCE_DRIVER = 16,  
    DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY = 32,  
    DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_FULL = 0,  
    DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_LIMITED = 0x00100000,  
    DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_sRGB_TO_REC709 = 0x00200000,  
    DXGIX_SWAP_CHAIN_MATCH_OTHER_CONSOLES = ( DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_FULL ),  
    DXGIX_SWAP_CHAIN_MATCH_XBOX360_AND_PC = ( DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_FULL | DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_sRGB_TO_REC709 ),  
    DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_RGB_BT2020_ST2084 = 0x00800000,  
    DXGIX_SWAP_CHAIN_FLAG_AUTOMATIC_GAMEDVR_TONEMAP = 0x02000000,  
} DXGI_SWAP_CHAIN_FLAG  

Constantes

Constante	Description
DXGI_SWAP_CHAIN_FLAG_NONPREROTATED	Définissez cet indicateur pour désactiver la rotation automatique de l’image; autrement dit, aucune rotation n’est effectuée lors du transfert du contenu de la mémoire tampon d’avant-plan vers le moniteur.
Utilisez cet indicateur pour éviter une pénalité de bande passante lorsqu’une application prévoit de gérer la rotation. Cette option n’est valide qu’en mode plein écran.
DXGI_SWAP_CHAIN_FLAG_ALLOW_MODE_SWITCH	Définissez cet indicateur pour permettre à une application de changer de mode en appelant IDXGISwapChain::ResizeTarget.
Lors du passage du mode fenêtré au mode plein écran, le mode d’affichage (ou la résolution du moniteur) est modifié pour correspondre aux dimensions de la fenêtre de l’application.
DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLE	Définissez cet indicateur pour permettre à une application d’effectuer le rendu à l’aide de GDI sur une chaîne d’échange ou une surface. Cela permet à l’application d’appeler IDXGISurface1::GetDC sur la mémoire tampon d’arrière-plan 0 ou sur une surface. Cet indicateur ne s’applique pas à Direct3D 12.
DXGI_SWAP_CHAIN_FLAG_RESTRICTED_CONTENT	Définissez cet indicateur pour indiquer que la chaîne d’échange peut contenir du contenu protégé; par conséquent, le système d’exploitation ne prend en charge la création de la chaîne d’échange que lorsque la protection du pilote et du matériel est utilisée. Si le pilote et le matériel ne prennent pas en charge la protection du contenu, l’appel visant à créer une ressource pour la chaîne d’échange échoue. Direct3D 11 : cette valeur d’énumération est prise en charge à partir de Windows 8.
DXGI_SWAP_CHAIN_FLAG_RESTRICT_SHARED_RESOURCE_DRIVER	Définissez cet indicateur pour indiquer que les ressources partagées créées dans la chaîne d’échange doivent être protégées à l’aide du mécanisme du pilote permettant de restreindre l’accès aux surfaces partagées. Direct3D 11 : cette valeur d’énumération est prise en charge à partir de Windows 8.
DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY	Définissez cet indicateur pour limiter le contenu présenté aux écrans locaux. Le contenu présenté n’est donc pas accessible par accès à distance ni au moyen des API de duplication du bureau. Cet indicateur prend en charge les fonctionnalités de protection du contenu des fenêtres de Windows. Les applications peuvent utiliser cet indicateur pour empêcher que le contenu de leurs propres fenêtres à l’écran soit capturé ou copié au moyen d’un ensemble précis de fonctionnalités et d’API publiques du système d’exploitation. Si vous utilisez cet indicateur avec des chaînes d’échange fenêtrées (HWND ou IWindow) dont le HWND a été créé par un autre processus, le propriétaire du HWND doit utiliser correctement la fonction SetWindowDisplayAffinity afin que les appels à IDXGISwapChain::Present ou IDXGISwapChain1::Present1 réussissent. Direct3D 11 : cette valeur d’énumération est prise en charge à partir de Windows 8.
DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_FULL	Déconseillé
DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_LIMITED	Déconseillé
DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_sRGB_TO_REC709	Déconseillé
DXGIX_SWAP_CHAIN_MATCH_OTHER_CONSOLES	Déconseillé
DXGIX_SWAP_CHAIN_MATCH_XBOX360_AND_PC	Déconseillé
DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_RGB_BT2020_ST2084	Déconseillé
DXGIX_SWAP_CHAIN_FLAG_AUTOMATIC_GAMEDVR_TONEMAP	Déconseillé

Remarques

Cette énumération est utilisée par la structure DXGI_SWAP_CHAIN_DESC et par la méthode IDXGISwapChain::ResizeTarget. Cette énumération est également utilisée par la structure DXGI_SWAP_CHAIN_DESC1. Vous n’avez pas besoin de définir DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY pour les chaînes d’échange que vous créez en mode plein écran avec la méthode IDXGIFactory::CreateSwapChain, car ces chaînes d’échange se comportent déjà comme si DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY était défini. Autrement dit, le contenu présenté n’est pas accessible par accès à distance ni au moyen des API de duplication du bureau. Les chaînes d’échange que vous créez avec les méthodes IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow et IDXGIFactory2::CreateSwapChainForComposition ne sont pas protégées si DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY n’est pas défini, et sont protégées si DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY est défini. Lorsque les chaînes d’échange sont protégées, la capture d’écran est empêchée et, en mode plein écran, le contenu présenté n’est pas accessible au moyen des API de duplication du bureau. Lorsque vous appelez IDXGISwapChain::ResizeBuffers pour modifier la mémoire tampon d’arrière-plan de la chaîne d’échange, vous pouvez réinitialiser ou modifier tous les indicateurs DXGI_SWAP_CHAIN_FLAG.

Configuration requise

En-tête : d3d12_xs.h
Plateformes prises en charge : consoles XBOX Series

Voir aussi

d3d12_xs

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Syntaxe

Constantes

Remarques

Configuration requise

Voir aussi

​Syntaxe

​Constantes

​Remarques

​Configuration requise

​Voir aussi

Syntaxe

Constantes

Remarques

Configuration requise

Voir aussi