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 |