Metodo IDirect3DDevice9::CreateAdditionalSwapChain (d3d9.h)

Articolo
08/23/2023

Crea una catena di scambio aggiuntiva per il rendering di più visualizzazioni.

Sintassi

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

Parametri

[in, out] pPresentationParameters

Tipo: D3DPRESENT_PARAMETERS*

Puntatore a una struttura D3DPRESENT_PARAMETERS contenente i parametri di presentazione per la nuova catena di scambio. Questo valore non può essere NULL.

La chiamata a questo metodo modifica il valore dei membri della struttura D3DPRESENT_PARAMETERS.

Se BackBufferCount == 0, la chiamata a CreateAdditionalSwapChain aumenterà a 1.
Se l'applicazione è in modalità finestra e, se BackBufferWidth o BackBufferHeight == 0, verranno impostate sulla larghezza e l'altezza dell'area client dell'oggetto hwnd.

[out, retval] pSwapChain

Tipo: IDirect3DSwapChain9**

Indirizzo di un puntatore a un'interfaccia IDirect3DSwapChain9 , che rappresenta la catena di scambio aggiuntiva.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_NOTAVAILABLE, D3DERR_DEVICELOST, D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY.

Commenti

Esiste sempre almeno una catena di scambio (la catena di scambio implicita) per ogni dispositivo perché Direct3D 9 ha una catena di scambio come proprietà del dispositivo.

Si noti che qualsiasi dispositivo specifico può supportare una sola catena di scambio a schermo intero.

D3DFMT_UNKNOWN può essere specificato per il formato del buffer nascosto in modalità finestra quando si chiama IDirect3D9::CreateDevice, IDirect3DDevice9::Reset e CreateAdditionalSwapChain. Ciò significa che l'applicazione non deve eseguire query sul formato desktop corrente prima di chiamare CreateDevice per la modalità finestra. Per la modalità schermo intero, è necessario specificare il formato del buffer nascosto.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	d3d9.h (include D3D9.h)
Libreria	D3D9.lib

Vedi anche

IDirect3DDevice9

Presentazione di più visualizzazioni in modalità finestra (Direct3D 9)

Share via