IDirect3DDevice9::CreateAdditionalSwapChain-Methode (d3d9.h)

  • Artikel

Erstellt eine zusätzliche Swapchain zum Rendern mehrerer Ansichten.

Syntax

HRESULT CreateAdditionalSwapChain(
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [out, retval] IDirect3DSwapChain9   **pSwapChain
);

Parameter

[in, out] pPresentationParameters

Typ: D3DPRESENT_PARAMETERS*

Zeiger auf eine D3DPRESENT_PARAMETERS-Struktur , die die Präsentationsparameter für die neue Swapchain enthält. Dieser Wert darf nicht NULL sein.

Durch Aufrufen dieser Methode wird der Wert der Member der D3DPRESENT_PARAMETERS-Struktur geändert.

  • Wenn BackBufferCount == 0 ist, wird der Wert durch Aufrufen von CreateAdditionalSwapChain auf 1 erhöht.
  • Wenn sich die Anwendung im Fenstermodus befindet und entweder BackBufferWidth oder BackBufferHeight == 0 ist, werden sie auf die Breite und Höhe des Clientbereichs des hwnd festgelegt.

[out, retval] pSwapChain

Typ: IDirect3DSwapChain9**

Adresse eines Zeigers auf eine IDirect3DSwapChain9-Schnittstelle , die die zusätzliche Swapchain darstellt.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert wie folgt aussehen: D3DERR_NOTAVAILABLE, D3DERR_DEVICELOST, D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY.

Hinweise

Es gibt immer mindestens eine Swapchain (die implizite Swapchain) für jedes Gerät, da Direct3D 9 über eine Swapchain als Eigenschaft des Geräts verfügt.

Beachten Sie, dass jedes gerät nur eine Vollbild-Swapchain unterstützen kann.

D3DFMT_UNKNOWN kann beim Aufrufen von IDirect3D9::CreateDevice, IDirect3DDevice9::Reset und CreateAdditionalSwapChain für das Pufferformat im Fenstermodus angegeben werden. Dies bedeutet, dass die Anwendung das aktuelle Desktopformat nicht abfragen muss, bevor CreateDevice für den Fenstermodus aufgerufen wird. Für den Vollbildmodus muss das Hintergrundpufferformat angegeben werden.

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d9.h (einschließlich D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DDevice9

Darstellen mehrerer Ansichten im Fenstermodus (Direct3D 9)