Share via


IDirect3DMobileDevice::GetTexture

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

HRESULT GetTexture(
  DWORD Stage,
  IDirect3DMobileBaseTexture** ppTexture
);

Parameters

  • Stage
    [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.

Return Value

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).

Remarks

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.

Requirements

Header d3dm.h
Library D3dm.lib, D3dmguid.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IDirect3DMobileDevice
IDirect3DMobileBaseTexture