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 |