IDirect3DDevice8::GetTexture

  • Article

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

HRESULT GetTexture(
  DWORD Stage,
  IDirect3DBaseTexture8** 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, retval] Address of a pointer to an IDirect3DBaseTexture8 interface, representing the returned texture.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be D3DERR_INVALIDCALL.

Remarks

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

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

IDirect3DBaseTexture8 | IDirect3DDevice8::GetTextureStageState | IDirect3DDevice8::SetTexture | IDirect3DDevice8::SetTextureStageState | IUnknown::Release | IDirect3DDevice8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.