Méthode IDirect3DDevice9::CreateAdditionalSwapChain (d3d9.h)
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.
Notes
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é.
Spécifications
| Plateforme cible | Windows |
| En-tête | d3d9.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |