Condividi tramite


Metodo IDirect3DDevice9::CreateAdditionalSwapChain (d3d9.h)

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)