IDirect3DDevice3::SetTexture

The IDirect3DDevice3::SetTexture method assigns a texture to a given stage for a device.

HRESULT  SetTexture( 
  DWORD dwStage,
  LPDIRECT3DTEXTURE2 lpTexture
);

Parameters

dwStage
Stage identifier to which the texture will be set. Stage identifiers are zero-based. Currently, devices can have up to 8 set textures, so the maximum allowable value allowed for dwStage is 7.
lpTexture
Address of the IDirect3DTexture2 interface for the texture being set.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value may be one of the following values:

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

Remarks

This method was introduced with the IDirect3DDevice3 interface.

Software devices do not support assigning a texture to more than one texture stage at a time.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in d3d.h.
  Import Library: Use ddraw.lib.

See Also

IDirect3DDevice3::GetTexture, IDirect3DDevice3::GetTextureStageState, IDirect3DDevice3::SetTextureStageState, Textures