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 .
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 |