Expand Minimize

IDirect3DDevice9::GetTexture method

Retrieves a texture assigned to a stage for a device.

Syntax


HRESULT GetTexture(
  [in]           DWORD Stage,
  [out, retval]  IDirect3DBaseTexture9 **ppTexture
);

Parameters

Stage [in]

Type: DWORD

Stage identifier of the texture to retrieve. Stage identifiers are zero-based.

ppTexture [out, retval]

Type: IDirect3DBaseTexture9**

Address of a pointer to an IDirect3DBaseTexture9 interface, representing the returned texture.

Return value

Type: HRESULT

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be D3DERR_INVALIDCALL.

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.

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

Requirements

Header

D3D9.h

Library

D3D9.lib

See also

IDirect3DDevice9
IDirect3DDevice9::SetTexture
IDirect3DDevice9::GetTextureStageState
IDirect3DDevice9::SetTextureStageState

 

 

Community Additions

ADD
Show:
© 2014 Microsoft