structure DXGI_SWAP_CHAIN_DESC1 (dxgi1_2.h)

Décrit une chaîne d’échange.

Syntaxe

typedef struct DXGI_SWAP_CHAIN_DESC1 {
  UINT             Width;
  UINT             Height;
  DXGI_FORMAT      Format;
  BOOL             Stereo;
  DXGI_SAMPLE_DESC SampleDesc;
  DXGI_USAGE       BufferUsage;
  UINT             BufferCount;
  DXGI_SCALING     Scaling;
  DXGI_SWAP_EFFECT SwapEffect;
  DXGI_ALPHA_MODE  AlphaMode;
  UINT             Flags;
} DXGI_SWAP_CHAIN_DESC1;

Membres

Width

Valeur qui décrit la largeur de résolution. Si vous spécifiez la largeur sur zéro lorsque vous appelez la méthode IDXGIFactory2 ::CreateSwapChainForHwnd pour créer une chaîne d’échange, le runtime obtient la largeur à partir de la fenêtre de sortie et affecte cette valeur de largeur à la description de la chaîne d’échange. Vous pouvez ensuite appeler la méthode IDXGISwapChain1 ::GetDesc1 pour récupérer la valeur de largeur affectée. Vous ne pouvez pas spécifier la largeur sur zéro lorsque vous appelez la méthode IDXGIFactory2 ::CreateSwapChainForComposition .

Height

Valeur qui décrit la hauteur de résolution. Si vous spécifiez la hauteur sur zéro lorsque vous appelez la méthode IDXGIFactory2 ::CreateSwapChainForHwnd pour créer une chaîne d’échange, le runtime obtient la hauteur de la fenêtre de sortie et affecte cette valeur de hauteur à la description de la chaîne d’échange. Vous pouvez ensuite appeler la méthode IDXGISwapChain1 ::GetDesc1 pour récupérer la valeur de hauteur affectée. Vous ne pouvez pas spécifier la hauteur de zéro lorsque vous appelez la méthode IDXGIFactory2 ::CreateSwapChainForComposition .

Format

Structure DXGI_FORMAT qui décrit le format d’affichage.

Stereo

Spécifie si le mode d’affichage plein écran ou la mémoire tampon d’arrière-chaîne d’échange est stéréo. TRUE si stéréo ; sinon, FALSE. Si vous spécifiez stéréo, vous devez également spécifier une chaîne d’échange de modèle inversé (autrement dit, une chaîne d’échange dont la valeur DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL est définie dans le membre SwapEffect ).

SampleDesc

Structure DXGI_SAMPLE_DESC qui décrit les paramètres d’échantillonnage multiple. Ce membre est valide uniquement avec les chaînes d’échange de modèle de transfert de bloc de bits (bitblt).

BufferUsage

Valeur de type DXGI_USAGE qui décrit l’utilisation de la surface et les options d’accès au processeur pour la mémoire tampon arrière. La mémoire tampon arrière peut être utilisée pour l’entrée du nuanceur ou la sortie cible de rendu.

BufferCount

Valeur qui décrit le nombre de mémoires tampons dans la chaîne d’échange. Lorsque vous créez une chaîne d’échange en plein écran, vous incluez généralement la mémoire tampon avant dans cette valeur.

Scaling

Valeur de type DXGI_SCALING qui identifie le comportement de redimensionnement si la taille de la mémoire tampon arrière n’est pas égale à la sortie cible.

SwapEffect

Valeur de type DXGI_SWAP_EFFECT qui décrit le modèle de présentation utilisé par la chaîne d’échange et les options de gestion du contenu de la mémoire tampon de présentation après la présentation d’une surface. Vous devez spécifier la valeur DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL lorsque vous appelez la méthode IDXGIFactory2 ::CreateSwapChainForComposition , car cette méthode prend uniquement en charge le modèle de présentation inversée.

AlphaMode

Valeur de type DXGI_ALPHA_MODE qui identifie le comportement de transparence de la mémoire tampon arrière de la chaîne d’échange.

Flags

Combinaison de valeurs de type DXGI_SWAP_CHAIN_FLAG qui sont combinées à l’aide d’une opération OR au niveau du bit. La valeur résultante spécifie des options pour le comportement de la chaîne d’échange.

Remarques

Cette structure est utilisée par les méthodes CreateSwapChainForHwnd, CreateSwapChainForCoreWindow, CreateSwapChainForComposition, CreateSwapChainForCompositionSurfaceHandle et GetDesc1 .

Note Vous ne pouvez pas caster un DXGI_SWAP_CHAIN_DESC1 dans un DXGI_SWAP_CHAIN_DESC et vice versa. Une application doit utiliser explicitement la méthode IDXGISwapChain1 ::GetDesc1 pour récupérer la version la plus récente de la structure de description de la chaîne d’échange.

 

En mode plein écran, il existe une mémoire tampon frontale dédiée ; en mode fenêtré, le bureau est la mémoire tampon avant.

Pour une chaîne d’échange de modèle inversé (autrement dit, une chaîne d’échange dont la valeur DXGI_SWAP_EFFECT_FLIP_DISCARD ou DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL est définie dans le membre SwapEffect ), vous devez définir le membre Format sur DXGI_FORMAT_R16G16B16A16_FLOAT, DXGI_FORMAT_B8G8R8A8_UNORM, DXGI_FORMAT_R8G8B8A8_UNORM ou DXGI_FORMAT_R10G10B10A10_UNORM ; vous devez définir le membre Count de la structure DXGI_SAMPLE_DESC que le membre SampleDesc spécifie sur un et le membre Qualité de DXGI_SAMPLE_DESC sur zéro, car plusieurs exemples d’anti-attirail (MSAA) ne sont pas pris en charge ; vous devez définir le membre BufferCount sur de deux à seize. Pour plus d’informations sur la chaîne d’échange de modèle inversé, consultez DXGI Flip Model.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
En-tête	dxgi1_2.h

Voir aussi

DXGI Structures

IDXGISwapChain1 ::GetDesc1