Microsoft DirectX 9.0

IDirect3DDevice9::GetDirect3D Method

Returns an interface to the instance of the Microsoft?Direct3D?object that created the device.


HRESULT GetDirect3D(      

    IDirect3D9 **ppD3D9 );


[out, retval] Address of a pointer to an IDirect3D9 interface, representing the interface of the Direct3D object that created the device.

Return Value

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be D3DERR_INVALIDCALL.


Calling IDirect3DDevice9::GetDirect3D increases the reference count on the interface, so applications should call IUnknown::Release through this pointer when finished with the interface.

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

© 2002 Microsoft Corporation. All rights reserved.