DXGI_SWAP_CHAIN_DESC structure (dxgi.h)

  • Article

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

Syntaxe

typedef struct DXGI_SWAP_CHAIN_DESC {
  DXGI_MODE_DESC   BufferDesc;
  DXGI_SAMPLE_DESC SampleDesc;
  DXGI_USAGE       BufferUsage;
  UINT             BufferCount;
  HWND             OutputWindow;
  BOOL             Windowed;
  DXGI_SWAP_EFFECT SwapEffect;
  UINT             Flags;
} DXGI_SWAP_CHAIN_DESC;

Membres

BufferDesc

Type : DXGI_MODE_DESC

Structure DXGI_MODE_DESC qui décrit le mode d’affichage du backbuffer.

SampleDesc

Type : DXGI_SAMPLE_DESC

Structure DXGI_SAMPLE_DESC qui décrit les paramètres de multi-échantillonnage.

BufferUsage

Type : DXGI_USAGE

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

BufferCount

Type : UINT

Valeur qui décrit le nombre de mémoires tampons dans la chaîne d’échange. Lorsque vous appelez IDXGIFactory::CreateSwapChain pour créer une chaîne d’échange en plein écran, vous incluez généralement la mémoire tampon avant dans cette valeur. Pour plus d’informations sur les mémoires tampons de chaîne d’échange, consultez Remarques.

OutputWindow

Type : HWND

Handle HWND dans la fenêtre de sortie. Ce membre ne doit pas être NULL.

Windowed

Type : BOOL

Valeur booléenne qui spécifie si la sortie est en mode fenêtré. TRUE si la sortie est en mode fenêtré ; sinon, FALSE.

Nous vous recommandons de créer une chaîne d’échange fenêtré et d’autoriser l’utilisateur final à modifier la chaîne d’échange en mode plein écran via IDXGISwapChain::SetFullscreenState; Autrement dit, ne définissez pas ce membre sur FALSE pour forcer la chaîne d’échange à être en plein écran. Toutefois, si vous créez la chaîne d’échange en mode plein écran, fournissez également à l’utilisateur final une liste des modes d’affichage pris en charge via le membre BufferDesc , car une chaîne d’échange créée avec un mode d’affichage non pris en charge peut rendre l’affichage noir et empêcher l’utilisateur final de voir quoi que ce soit.

Pour plus d’informations sur le choix des versets fenêtrés en mode plein écran, consultez IDXGIFactory::CreateSwapChain.

SwapEffect

Type : DXGI_SWAP_EFFECT

Un membre du DXGI_SWAP_EFFECT type énuméré qui décrit les options de gestion du contenu de la mémoire tampon de présentation après avoir présenté une surface.

Flags

Type : UINT

Un membre du DXGI_SWAP_CHAIN_FLAG type énuméré qui décrit les options pour le comportement de la chaîne d’échange.

Notes

Cette structure est utilisée par les méthodes GetDesc et CreateSwapChain .

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.

Si vous créez une chaîne d’échange avec une mémoire tampon, la spécification de DXGI_SWAP_EFFECT_SEQUENTIAL n’entraîne pas l’échange du contenu de la mémoire tampon unique avec la mémoire tampon avant.

Pour plus d’informations sur les performances relatives au basculement des mémoires tampons de chaîne d’échange dans une application plein écran, consultez Indicateurs de performances des applications en plein écran.

Spécifications

   
En-tête dxgi.h

Voir aussi

DXGI Structures

IDXGIFactory::CreateSwapChain

IDXGISwapChain