Metodo IDirect3DDevice9::GetRenderTargetData (d3d9.h)

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

Vedi anche

IDirect3DDevice9