Compartir a través de

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

  • Artículo

Crea una cadena de intercambio adicional para representar varias vistas.

Sintaxis

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

Parámetros

[in, out] pPresentationParameters

Tipo: D3DPRESENT_PARAMETERS*

Puntero a una estructura de D3DPRESENT_PARAMETERS que contiene los parámetros de presentación de la nueva cadena de intercambio. Este valor no puede ser NULL.

Al llamar a este método, se cambia el valor de los miembros de la estructura D3DPRESENT_PARAMETERS.

  • Si BackBufferCount == 0, llamar a CreateAdditionalSwapChain aumentará a 1.
  • Si la aplicación está en modo de ventana y, si BackBufferWidth o BackBufferHeight == 0, se establecerán en el ancho y alto del área de cliente del hwnd.

[out, retval] pSwapChain

Tipo: IDirect3DSwapChain9**

Dirección de un puntero a una interfaz IDirect3DSwapChain9 , que representa la cadena de intercambio adicional.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto puede ser uno de los siguientes: D3DERR_NOTAVAILABLE, D3DERR_DEVICELOST, D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Comentarios

Siempre hay al menos una cadena de intercambio (la cadena de intercambio implícita) para cada dispositivo porque Direct3D 9 tiene una cadena de intercambio como propiedad del dispositivo.

Tenga en cuenta que cualquier dispositivo determinado solo puede admitir una cadena de intercambio de pantalla completa.

D3DFMT_UNKNOWN se puede especificar para el formato de búfer de retroceso en modo ventana al llamar a IDirect3D9::CreateDevice, IDirect3DDevice9::Reset y CreateAdditionalSwapChain. Esto significa que la aplicación no tiene que consultar el formato de escritorio actual antes de llamar a CreateDevice para el modo de ventana. Para el modo de pantalla completa, se debe especificar el formato del búfer de reserva.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d9helper.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

IDirect3DDevice9

Presentación de varias vistas en modo de ventana (Direct3D 9)