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.

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

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

See Also

Reference

IDirect3DMobileDevice
IDirect3DMobileBaseTexture