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

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

Sintaxis

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

Parámetros

[in] iSwapChain

Tipo: UINT

Entero sin signo que especifica la cadena de intercambio.

[in] pDestSurface

Tipo: IDirect3DSurface9*

Puntero a una interfaz IDirect3DSurface9 que recibirá una copia del contenido del búfer frontal. Los datos se devuelven en filas sucesivas sin espacio intermedio, empezando desde la fila verticalmente más alta de la salida del dispositivo hasta el más bajo.

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 se produce un error en el método, el valor devuelto puede ser uno de los siguientes: D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST, D3DERR_INVALIDCALL

Comentarios

El búfer al que apunta pDestSurface se rellenará con una representación del búfer frontal, convertido a los 32 bits estándar por formato de píxel D3DFMT_A8R8G8B8.

Este método es la única manera de capturar una captura de pantalla antialiased.

Esta función es muy lenta, por diseño, y no debe usarse en ninguna ruta de acceso crítica para el rendimiento.

Para obtener más información, vea Dispositivos perdidos y datos recuperados.

Requisitos

Consulte también

IDirect3DDevice9