Metodo IDirect3DDevice9::GetRenderTarget (d3d9helper.h)
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 |