IDirect3DDevice7::SetTextureStageState

The IDirect3DDevice7::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 is to be set. Stage identifiers are zero-based. Currently, devices can have up to eight 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 can be one of the following values:

Remarks

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Version: Requires DirectX 7.0.
  Header: Declared in d3d.h.

See Also

IDirect3DDevice7::GetTextureStageState, IDirect3DDevice7::GetTexture, IDirect3DDevice7::SetTexture, Textures