IDirect3DDevice9::GetLightEnable method (d3d9helper.h)

Retrieves the activity status - enabled or disabled - for a set of lighting parameters within a device.

Syntax

HRESULT GetLightEnable(
  [in]          DWORD Index,
  [out, retval] BOOL  *pEnable
);

Parameters

[in] Index

Type: DWORD

Zero-based index of the set of lighting parameters that are the target of this method.

[out, retval] pEnable

Type: BOOL*

Pointer to a variable to fill with the status of the specified lighting parameters. After the call, a nonzero value at this address indicates that the specified lighting parameters are enabled; a value of 0 indicates that they are disabled.

Return value

Type: HRESULT

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be D3DERR_INVALIDCALL.

Remarks

This method will not return device state for a device that is created using D3DCREATE_PUREDEVICE. If you want to use this method, you must create your device with any of the other values in D3DCREATE.

Requirements

Requirement Value
Target Platform Windows
Header d3d9helper.h (include D3D9.h)
Library D3D9.lib

See also

IDirect3DDevice9

IDirect3DDevice9::GetLight

IDirect3DDevice9::LightEnable

IDirect3DDevice9::SetLight