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 |