IDirect3DDevice7::SetRenderState

The IDirect3DDevice7::SetRenderState method sets a single Direct3DDevice render-state parameter.

HRESULT SetRenderState(
  D3DRENDERSTATETYPE dwRenderStateType,  
  DWORD dwRenderState                    
);

Parameters

dwRenderStateType

Device state variable that is being modified. This parameter can be any of the members of the D3DRENDERSTATETYPE enumerated type.

dwRenderState

New value for the Direct3DDevice render state. The meaning of this parameter is dependent on the value specified for dwRenderStateType. For example, if dwRenderStateType were D3DRENDERSTATE_SHADEMODE, the second parameter would be one of the members of the D3DSHADEMODE enumerated type.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value is an error. The method returns DDERR_INVALIDPARAMS if one of the arguments is invalid.

Remarks

Applications should use the IDirect3DDevice7::SetTextureStageState method to set texture states, rather than the legacy texture-related 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::GetRenderState, IDirect3DDevice7::SetTransform, About Render States