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

Weitere Informationen

DXGI-Strukturen

IDXGISwapChain1::GetDesc1