DXGI_SWAP_CHAIN_DESC-Struktur (dxgi.h)

Beschreibt eine Swapchain.

Syntax

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;

Member

BufferDesc

Typ: DXGI_MODE_DESC

Eine DXGI_MODE_DESC-Struktur , die den Anzeigemodus des Backbuffers beschreibt.

SampleDesc

Typ: DXGI_SAMPLE_DESC

Eine DXGI_SAMPLE_DESC-Struktur , die Multi-Sampling-Parameter beschreibt.

BufferUsage

Typ: DXGI_USAGE

Ein Member des DXGI_USAGE aufgezählten Typs, der die Oberflächennutzung und CPU-Zugriffsoptionen für den Backpuffer beschreibt. Der Hintergrundpuffer kann für die Shadereingabe oder Renderzielausgabe verwendet werden.

BufferCount

Typ: UINT

Ein -Wert, der die Anzahl der Puffer in der Swapchain beschreibt. Wenn Sie IDXGIFactory::CreateSwapChain aufrufen, um eine Vollbild-Swapchain zu erstellen, schließen Sie in der Regel den Frontpuffer in diesen Wert ein. Weitere Informationen zu Swapchainpuffern finden Sie unter Hinweise.

OutputWindow

Typ: HWND

Ein HWND-Handle zum Ausgabefenster. Dieser Member darf nicht NULL sein.

Windowed

Typ: BOOL

Ein boolescher Wert, der angibt, ob sich die Ausgabe im Fenstermodus befindet. TRUE , wenn sich die Ausgabe im Fenstermodus befindet; andernfalls FALSE.

Es wird empfohlen, eine Swapchain mit Fenstern zu erstellen und dem Endbenutzer zu erlauben, die Swapchain über IDXGISwapChain::SetFullscreenState in Vollbild zu ändern. Das heißt, legen Sie diesen Member nicht auf FALSE fest, um zu erzwingen, dass die Swapchain vollbildig ist. Wenn Sie die Swapchain jedoch als Vollbild erstellen, stellen Sie dem Endbenutzer auch eine Liste der unterstützten Anzeigemodi über das BufferDesc-Element bereit, da eine Swapchain, die mit einem nicht unterstützten Anzeigemodus erstellt wird, dazu führen kann, dass die Anzeige schwarz wird und der Endbenutzer nicht mehr angezeigt wird.

Weitere Informationen zum Auswählen von Fensterversen im Vollbild finden Sie unter IDXGIFactory::CreateSwapChain.

SwapEffect

Typ: DXGI_SWAP_EFFECT

Ein Member des DXGI_SWAP_EFFECT aufgelisteten Typs, der Optionen für die Behandlung des Inhalts des Präsentationspuffers nach dem Präsentieren einer Oberfläche beschreibt.

Flags

Typ: UINT

Ein Member des DXGI_SWAP_CHAIN_FLAG aufgelisteten Typs, der Optionen für das Swapkettenverhalten beschreibt.

Hinweise

Diese Struktur wird von den Methoden GetDesc und CreateSwapChain verwendet.

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

Wenn Sie eine Swapchain mit einem Puffer erstellen, führt die Angabe DXGI_SWAP_EFFECT_SEQUENTIAL nicht dazu, dass der Inhalt des einzelnen Puffers durch den Frontpuffer getauscht wird.

Leistungsinformationen zum Kippen von Swapchainpuffern in Einer Vollbildanwendung finden Sie unter Leistungshinweise für Vollbildanwendungen.

Anforderungen

Kopfzeile	dxgi.h

Weitere Informationen

DXGI-Strukturen

IDXGIFactory::CreateSwapChain

IDXGISwapChain