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
| Plataforma de destino | Windows |
| Encabezado | d3d9helper.h (incluya D3D9.h) |
| Library | D3D9.lib |