IDirect3DDevice9::CreateAdditionalSwapChain-Methode (d3d9.h)
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 |