Metodo IDirect3DDevice9::CreateAdditionalSwapChain (d3d9helper.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, chiamando CreateAdditionalSwapChain lo aumenterà a 1.
Se l'applicazione è in modalità finestrata e, se BackBufferWidth o BackBufferHeight == 0, verranno impostate sulla larghezza dell'area client e sull'altezza dell'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 è 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

C'è 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 specificato può supportare una sola catena di scambio a schermo intero.

D3DFMT_UNKNOWN può essere specificato per il formato del buffer back della 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 indietro.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	d3d9helper.h (include D3D9.h)
Libreria	D3D9.lib

Vedi anche

IDirect3DDevice9

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

Share via