Microsoft DirectX 8.1 (C++)

IDirect3DSurface8::GetDevice

Retrieves the device associated with a surface.

HRESULT GetDevice(
  IDirect3DDevice8** ppDevice
);

Parameters

ppDevice
[out, retval] Address of a pointer to an IDirect3DDevice8 interface to fill with the device pointer, if the query succeeds.

Return Values

If the method succeeds, the return value is D3D_OK.

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

Remarks

This method allows navigation to the owning device object.

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

Requirements

  Header: Declared in D3d8.h.
  Import Library: Use D3d8.lib.