Méthode IDirect3DDevice9 ::CreateAdditionalSwapChain (d3d9helper.h)

  • Article

Crée une chaîne d’échange supplémentaire pour le rendu de plusieurs vues.

Syntaxe

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

Paramètres

[in, out] pPresentationParameters

Type : D3DPRESENT_PARAMETERS*

Pointeur vers une structure D3DPRESENT_PARAMETERS , contenant les paramètres de présentation de la nouvelle chaîne d’échange. Cette valeur ne peut pas être NULL.

L’appel de cette méthode modifie la valeur des membres de la structure D3DPRESENT_PARAMETERS.

  • Si BackBufferCount == 0, l’appel de CreateAdditionalSwapChain l’augmente à 1.
  • Si l’application est en mode fenêtré, et si BackBufferWidth ou BackBufferHeight == 0, ils seront définis sur la largeur et la hauteur de la zone cliente du hwnd.

[out, retval] pSwapChain

Type : IDirect3DSwapChain9**

Adresse d’un pointeur vers une interface IDirect3DSwapChain9 , représentant la chaîne d’échange supplémentaire.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être l’une des suivantes : D3DERR_NOTAVAILABLE, D3DERR_DEVICELOST, D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Remarques

Il existe toujours au moins une chaîne d’échange (chaîne d’échange implicite) pour chaque appareil, car Direct3D 9 a une chaîne d’échange comme propriété de l’appareil.

Notez qu’un appareil donné ne peut prendre en charge qu’une seule chaîne de permutation en plein écran.

D3DFMT_UNKNOWN peut être spécifié pour le format de mémoire tampon arrière en mode fenêtré lors de l’appel de IDirect3D9 ::CreateDevice, IDirect3DDevice9 ::Reset et CreateAdditionalSwapChain. Cela signifie que l’application n’a pas besoin d’interroger le format de bureau actuel avant d’appeler CreateDevice pour le mode fenêtré. Pour le mode plein écran, le format de mémoire tampon arrière doit être spécifié.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d9helper.h (incluez D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DDevice9

Présentation de plusieurs vues en mode fenêtré (Direct3D 9)