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.

Hinweis Sie können eine DXGI_SWAP_CHAIN_DESC1 nicht in eine DXGI_SWAP_CHAIN_DESC umwandeln und umgekehrt. Eine Anwendung muss explizit die IDXGISwapChain1::GetDesc1-Methode verwenden, um die neuere Version der Swap-Chain-Beschreibungsstruktur abzurufen.

 

Im Vollbildmodus gibt es einen dedizierten Frontpuffer; Im Fenstermodus ist der Desktop der Frontpuffer.

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

Weitere Informationen

DXGI-Strukturen

IDXGISwapChain1::GetDesc1