DXGI_SWAP_CHAIN_DESC1-Struktur (dxgi1_2.h)
Beschreibt eine Swapchain.
Syntax
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;
Member
Width
Ein Wert, der die Auflösungsbreite beschreibt. Wenn Sie die Breite als Null angeben, wenn Sie die IDXGIFactory2::CreateSwapChainForHwnd-Methode aufrufen, um eine Swapchain-Kette zu erstellen, ruft die Runtime die Breite aus dem Ausgabefenster ab und weist diesen Breitenwert der Swap-Chain-Beschreibung zu. Anschließend können Sie die IDXGISwapChain1::GetDesc1-Methode aufrufen, um den zugewiesenen Breitenwert abzurufen. Sie können die Breite nicht als 0 angeben, wenn Sie die IDXGIFactory2::CreateSwapChainForComposition-Methode aufrufen.
Height
Ein Wert, der die Auflösungshöhe beschreibt. Wenn Sie die Höhe als Null angeben, wenn Sie die IDXGIFactory2::CreateSwapChainForHwnd-Methode aufrufen, um eine Swapchain-Kette zu erstellen, ruft die Runtime die Höhe aus dem Ausgabefenster ab und weist diesen Höhenwert der Swap-Chain-Beschreibung zu. Anschließend können Sie die IDXGISwapChain1::GetDesc1-Methode aufrufen, um den zugewiesenen Höhenwert abzurufen. Sie können die Höhe nicht als 0 angeben, wenn Sie die IDXGIFactory2::CreateSwapChainForComposition-Methode aufrufen.
Format
Eine DXGI_FORMAT-Struktur , die das Anzeigeformat beschreibt.
Stereo
Gibt an, ob der Vollbildanzeigemodus oder der Swap-Chain-Back-Puffer Stereo ist. TRUE , wenn Stereo; andernfalls FALSE. Wenn Sie Stereo angeben, müssen Sie auch eine Flip-Model-Swapchain angeben (d. a. eine Swapchain, für die der DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL Wert im SwapEffect-Member festgelegt ist).
SampleDesc
Eine DXGI_SAMPLE_DESC-Struktur , die Parameter für mehrere Stichproben beschreibt. Dieser Member ist nur bei Bitblockübertragungs-Modell-Swapchains (Bitblt) gültig.
BufferUsage
Ein DXGI_USAGE typisierter Wert, der die Oberflächennutzungs- und CPU-Zugriffsoptionen für den Backpuffer beschreibt. Der Backpuffer kann für Shadereingaben oder Renderzielausgaben verwendet werden.
BufferCount
Ein Wert, der die Anzahl der Puffer in der Swapchain beschreibt. Wenn Sie eine Vollbild-Swapchain erstellen, schließen Sie in der Regel den Frontpuffer in diesen Wert ein.
Scaling
Ein DXGI_SCALING typisierter Wert, der das Größenänderungsverhalten angibt, wenn die Größe des Backpuffers nicht der Zielausgabe entspricht.
SwapEffect
Ein DXGI_SWAP_EFFECT typisierter Wert, der das von der Swapchain verwendete Darstellungsmodell und Optionen zum Behandeln des Inhalts des Präsentationspuffers nach dem Präsentieren einer Oberfläche beschreibt. Sie müssen den DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL-Wert angeben, wenn Sie die IDXGIFactory2::CreateSwapChainForComposition-Methode aufrufen, da diese Methode nur das Flip-Präsentationsmodell unterstützt.
AlphaMode
Ein DXGI_ALPHA_MODE typisierter Wert, der das Transparenzverhalten des Swap-Chain-Back-Puffers angibt.
Flags
Eine Kombination aus DXGI_SWAP_CHAIN_FLAG typisierten Werten, die mithilfe eines bitweisen OR-Vorgangs kombiniert werden. Der resultierende Wert gibt Optionen für das Swapchainverhalten an.
Hinweise
Diese Struktur wird von den Methoden CreateSwapChainForHwnd, CreateSwapChainForCoreWindow, CreateSwapChainForComposition, CreateSwapChainForCompositionSurfaceHandle und GetDesc1 verwendet.
Für eine Flip-Model-Swapchain (d. a. eine Swapchain, bei der der DXGI_SWAP_EFFECT_FLIP_DISCARD oder DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL Wert im SwapEffect-Element festgelegt ist), müssen Sie den Format-Member auf DXGI_FORMAT_R16G16B16A16_FLOAT, DXGI_FORMAT_B8G8R8A8_UNORM, DXGI_FORMAT_R8G8B8A8_UNORM oder DXGI_FORMAT_R10G10B10A10_UNORM festlegen. Sie müssen das Count-Element der DXGI_SAMPLE_DESC Struktur festlegen, die das SampleDesc-Member angibt, auf 1 und den Quality-Member von DXGI_SAMPLE_DESC auf 0, da mehrere Stichproben-Antialiasing (MSAA) nicht unterstützt wird. Sie müssen den BufferCount-Member auf zwei bis sechzehn festlegen. Weitere Informationen zur Flip-Model-Swap chain finden Sie unter DXGI Flip Model.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
| Kopfzeile | dxgi1_2.h |