Metodo IDirect3DDevice9::GetRenderTarget (d3d9helper.h)

  • Articolo

Recupera una superficie di destinazione di rendering.

Sintassi

HRESULT GetRenderTarget(
  [in]  DWORD             RenderTargetIndex,
  [out] IDirect3DSurface9 **ppRenderTarget
);

Parametri

[in] RenderTargetIndex

Tipo: DWORD

Indice della destinazione di rendering. Vedere la sezione Osservazioni.

[out] ppRenderTarget

Tipo: IDirect3DSurface9**

Indirizzo di un puntatore a un'interfaccia IDirect3DSurface9 che rappresenta la superficie di destinazione di rendering restituita per questo dispositivo.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere D3DERR_INVALIDCALL se uno degli argomenti non è valido o D3DERR_NOTFOUND se non è disponibile alcuna destinazione di rendering per l'indice specificato.

Commenti

In genere, i metodi che restituiscono lo stato non funzioneranno in un dispositivo creato usando D3DCREATE_PUREDEVICE. Questo metodo, tuttavia, funzionerà anche in un dispositivo puro perché restituisce un'interfaccia.

Il dispositivo può ora supportare più destinazioni di rendering. Il numero di destinazioni di rendering supportate da un dispositivo è contenuto nel membro NumSimultaneousRTs di D3DCAPS9. Vedere Più destinazioni di rendering (Direct3D 9).

La chiamata a questo metodo aumenterà il conteggio dei riferimenti interni nell'interfaccia IDirect3DSurface9 . Se non si chiama IUnknown::Release al termine dell'uso dell'interfaccia IDirect3DSurface9 , si verifica una perdita di memoria.

Requisiti

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

Vedi anche

IDirect3DDevice9

IDirect3DDevice9::SetRenderTarget