Metodo IDirect3DDevice9::GetRenderTargetData (d3d9helper.h)

  • Articolo

Copia i dati di destinazione del rendering dalla memoria del dispositivo alla memoria di sistema.

Sintassi

HRESULT GetRenderTargetData(
  [in] IDirect3DSurface9 *pRenderTarget,
  [in] IDirect3DSurface9 *pDestSurface
);

Parametri

[in] pRenderTarget

Tipo: IDirect3DSurface9*

Puntatore a un oggetto IDirect3DSurface9 che rappresenta una destinazione di rendering.

[in] pDestSurface

Tipo: IDirect3DSurface9*

Puntatore a un oggetto IDirect3DSurface9 che rappresenta una superficie di destinazione.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST, D3DERR_INVALIDCALL.

Commenti

La superficie di destinazione deve essere una superficie normale fuori schermo o un livello di trama (mipmap o trama del cubo) creata con D3DPOOL_SYSTEMMEM.

La superficie di origine deve essere una destinazione di rendering regolare o un livello di trama di destinazione di rendering (mipmap o trama del cubo) creata con POOL_DEFAULT.

Questo metodo avrà esito negativo se:

  • La destinazione di rendering è multicampionata.
  • La destinazione di rendering dell'origine è una dimensione diversa rispetto alla superficie di destinazione.
  • I formati di superficie di rendering e destinazione di origine non corrispondono.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione d3d9helper.h (include D3D9.h)
Libreria D3D9.lib

Vedi anche

IDirect3DDevice9