IDirect3DDevice3::SetLightState

The IDirect3DDevice3::SetLightState method sets a single Direct3DDevice lighting-related state value.

HRESULT SetLightState(
  D3DLIGHTSTATETYPE dwLightStateType,  
  DWORD dwLightState                   
);
 

Parameters

dwLightStateType

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

dwLightState

New value for the Direct3DDevice light state. The meaning of this parameter is dependent on the value specified for dwLightStateType. For example, if dwLightStateType were D3DLIGHTSTATE_COLORMODEL, the second parameter would be one of the values of the D3DCOLORMODEL data 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

This method was introduced with the IDirect3DDevice2 interface.

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::GetLightState, IDirect3DDevice3::SetRenderState, IDirect3DDevice3::SetTransform