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

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

Sintaxis

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

Parámetros

[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: 1. Un valor de 0 devuelve el primer búfer de reserva, no el búfer frontal. No se puede acceder al búfer frontal a través de este método. Use IDirect3DSwapChain9::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 ejecuta correctamente, el valor devuelto es D3D_OK. Si BackBuffer supera o es igual al número total de búferes de reserva, la función produce un error y devuelve D3DERR_INVALIDCALL.

Comentarios

Llamar a este método aumentará el recuento de referencias internas en la interfaz IDirect3DSurface9 . Si no se llama a IUnknown::Release cuando termine de usar esta interfaz IDirect3DSurface9 , se producirá una pérdida de memoria. Debe liberar cualquier superficie obtenida a través de este método antes de liberar la cadena de intercambio a la que pertenece.

Requisitos

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

Consulte también

IDirect3DSwapChain9

IDirect3DSwapChain9::GetFrontBufferData