IDirect3DDevice3::SetTextureStageState

The IDirect3DDevice3::SetTextureStageState method sets the state value for a currently assigned texture.

HRESULT SetTextureStageState( 
  DWORD dwStage,
  D3DTEXTURESTAGESTATETYPE dwState,
  DWORD dwValue
);

Parameters

dwStage
Stage identifier of the texture for which the state value 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.
dwState
Texture state to be set. This parameter can be any member of the D3DTEXTURESTAGESTATETYPE enumerated type.
dwValue
State value to be set. The meaning of this value is determined by the dwState parameter.

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.

Applications should use this method to set texture states in favor of the legacy texture-related render states. For more information, see About Render States.

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::GetTextureStageState, IDirect3DDevice3::GetTexture, IDirect3DDevice3::SetTexture, Textures