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

Genera una copia del búfer frontal de la cadena de intercambio y los lugares que copian en un búfer de memoria del sistema proporcionado por la aplicación.

Sintaxis

HRESULT GetFrontBufferData(
  [in, out] IDirect3DSurface9 *pDestSurface
);

Parámetros

[in, out] pDestSurface

Tipo: IDirect3DSurface9*

Puntero a una interfaz IDirect3DSurface9 que recibirá una copia del búfer frontal de la cadena de intercambio. Los datos se devuelven en filas sucesivas sin espacio intermedio, empezando desde la fila verticalmente más alta hasta la más baja. En el modo con ventana, el tamaño de la superficie de destino debe ser el tamaño del escritorio. Para el modo de pantalla completa, el tamaño de la superficie de destino debe ser el tamaño de pantalla.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si BackBuffer supera o es igual al 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

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

Consulte también

IDirect3DSwapChain9