IDirect3DMobileDevice::GetTexture (Windows CE 5.0)

Send Feedback

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

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

Parameters

• Stage
  [in] Stage identifier of the texture to retrieve. Stage identifiers are zero-based. Devices can have up to eight set textures, so the maximum value allowed for Stage is 7.
• ppTexture
  [out] Address of a pointer to an IDirect3DMobileBaseTexture interface that represents the returned texture.

Return Values

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

OS Versions: Windows CE 5.0 and later.
Header: D3dm.h.
Link Library: D3dm.lib, D3dmguid.lib.

See Also

IDirect3DMobileDevice | IDirect3DMobileBaseTexture

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.