Windows Mobile 6.5
A version of this page is also available for

This method retrieves a texture assigned to a stage for a device.

HRESULT GetTexture(
  DWORD Stage,
  IDirect3DMobileBaseTexture** ppTexture


[in] Stage identifier of the texture to retrieve. Stage identifiers are zero-based. The maximum number of texture stage states is defined in D3DM_TEXSTAGECOUNT and the number of texture stages supported by the device is in D3DMCAPS as MaxTextureBlendStages.


[out] Address of a pointer to an IDirect3DMobileBaseTexture interface that represents the returned texture.

If the method succeeds, the return value is D3DM_OK (see D3DM Values).

If the method fails, the return value can be D3DMERR_INVALIDCALL (see D3DMERR Values).

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

LibraryD3dm.lib, D3dmguid.lib
Windows Embedded CEWindows CE 5.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions