IDirect3DMobileDevice::GetTexture
A version of this page is also available for
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
| 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 |