IDirect3DViewport::NextLight

HRESULT NextLight(LPDIRECT3DLIGHT lpDirect3DLight,

LPDIRECT3DLIGHT* lplpDirect3DLight, DWORD dwFlags);

Enumerates the Direct3DLight objects associated with the viewport.

·Returns D3D_OK if successful, or an error otherwise, which may be one of the following values:

DDERR_INVALIDOBJECT

DDERR_INVALIDPARAMS

lpDirect3DLight

Address of a light in the list of lights associated with this Direct3DDevice object.

lplpDirect3DLight

Address of a pointer that will contain the requested light in the list of lights associated with this Direct3DDevice object. The requested light is specified in the dwFlags parameter.

dwFlags

Flags specifying which light to retrieve from the list of lights. The default setting is D3DNEXT_NEXT.

D3DNEXT_HEAD Retrieve the item at the beginning of the list.

D3DNEXT_NEXT Retrieve the next item in the list.

D3DNEXT_TAIL Retrieve the item at the end of the list.