Compartir a través de

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

  • Artículo

Recupera un búfer de reserva de la cadena de intercambio del dispositivo.

Sintaxis

HRESULT GetBackBuffer(
  [in]          UINT               iSwapChain,
  [in]          UINT               iBackBuffer,
  [in]          D3DBACKBUFFER_TYPE Type,
  [out, retval] IDirect3DSurface9  **ppBackBuffer
);

Parámetros

[in] iSwapChain

Tipo: UINT

Entero sin signo que especifica la cadena de intercambio.

[in] iBackBuffer

Tipo: UINT

Índice del objeto de búfer de reserva que se va a devolver. Los búferes de reserva se numeran de 0 al número total de búferes de reserva menos uno. Un valor de 0 devuelve el primer búfer de reserva, no el búfer frontal. El búfer frontal no es accesible a través de este método. Use IDirect3DDevice9::GetFrontBufferData para recuperar una copia del búfer frontal.

[in] Type

Tipo: D3DBACKBUFFER_TYPE

La vista estéreo no se admite en Direct3D 9, por lo que el único valor válido para este parámetro es D3DBACKBUFFER_TYPE_MONO.

[out, retval] ppBackBuffer

Tipo: IDirect3DSurface9**

Dirección de un puntero a una interfaz IDirect3DSurface9 , que representa la superficie de búfer de reserva devuelta.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si BackBuffer es igual o supera el número total de búferes de reserva, se produce un error en la función y devuelve D3DERR_INVALIDCALL.

Comentarios

Al llamar a este método, aumentará el número de referencias internas en la interfaz IDirect3DSurface9 . Si no se llama a IUnknown::Release cuando termine de usar esta interfaz IDirect3DSurface9 , se producirá una fuga de memoria.

Requisitos

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

Consulte también

IDirect3DDevice9

IDirect3DDevice9::GetFrontBufferData