Método IDirect3DDevice9::GetRenderTarget (d3d9helper.h)
Recupera una superficie de destino de representación.
Sintaxis
HRESULT GetRenderTarget(
[in] DWORD RenderTargetIndex,
[out] IDirect3DSurface9 **ppRenderTarget
);
Parámetros
[in] RenderTargetIndex
Tipo: DWORD
Índice del destino de representación. Vea la sección Comentarios.
[out] ppRenderTarget
Tipo: IDirect3DSurface9**
Dirección de un puntero a una interfaz IDirect3DSurface9 , que representa la superficie de destino de representación devuelta para este dispositivo.
Valor devuelto
Tipo: HRESULT
Si el método se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto puede ser D3DERR_INVALIDCALL si uno de los argumentos no es válido o D3DERR_NOTFOUND si no hay ningún destino de representación disponible para el índice especificado.
Comentarios
Normalmente, los métodos que devuelven el estado no funcionarán en un dispositivo que se crea mediante D3DCREATE_PUREDEVICE. Sin embargo, este método funcionará incluso en un dispositivo puro porque devuelve una interfaz.
El dispositivo ahora puede admitir varios destinos de representación. El número de destinos de representación admitidos por un dispositivo se encuentra en el miembro NumSimultaneousRTs de D3DCAPS9. Consulta Varios destinos de representación (Direct3D 9).
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 la interfaz IDirect3DSurface9 , se producirá una pérdida de memoria.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | d3d9helper.h (incluya D3D9.h) |
| Library | D3D9.lib |