d3d9.dllGetRenderTarget
Microsoft DirectX 9.0 SDK Update (October 2004)

IDirect3DDevice9::GetRenderTarget Method


Retrieves a render-target surface.

Syntax

HRESULT GetRenderTarget(      

    DWORD RenderTargetIndex,     IDirect3DSurface9 **ppRenderTarget );

Parameters

RenderTargetIndex
[in] Index of the render target. See Remarks.
ppRenderTarget
[out] Address of a pointer to an IDirect3DSurface9 interface, representing the returned render-target surface for this device.

Return Value

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be D3DERR_INVALIDCALL if one of the arguments is invalid, or D3DERR_NOTFOUND if there's no render target available for the given index.

Remarks

Typically, methods that return state will not work on a device that is created using D3DCREATE_PUREDEVICE. This method however, will work even on a pure device because it returns an interface.

The device can now support multiple render targets. The number of render targets supported by a device is contained in the NumSimultaneousRTs member of D3DCAPS9. See Multiple Render Targets.

Calling this method will increase the internal reference count on the IDirect3DSurface9 interface. Failure to call IUnknown::Release when finished using the IDirect3DSurface9 interface results in a memory leak.

See Also

IDirect3DDevice9::SetRenderTarget


© 2004 Microsoft Corporation. All rights reserved.
Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center.