CHWRMLight Class Reference

#include <hwrmlight.h>

Link against: hwrmlightclient.lib

class CHWRMLight : public CBase, public CBase

Inherits from

CHWRMLight
- CBase
- CBase

Public Member Enumerations
enum	TLightStatus { ELightStatusUnknown, ELightOn, ELightOff, ELightBlink }
enum	TLightTarget { ENoTarget, EPrimaryDisplay, EPrimaryKeyboard, EPrimaryDisplayAndKeyboard, ..., ESystemTarget }

Public Member Functions
	~CHWRMLight()
virtual void	LightBlinkL(TInt)
virtual void	LightBlinkL(TInt, TInt)
virtual void	LightBlinkL(TInt, TInt, TInt, TInt, TInt)
IMPORT_C void	LightBlinkL(TInt, TInt, const THWRMLightColor &)
IMPORT_C void	LightBlinkL(TInt, TInt, TInt, TInt, TInt, const THWRMLightColor &)
virtual void	LightOffL(TInt)
virtual void	LightOffL(TInt, TInt)
virtual void	LightOffL(TInt, TInt, TBool)
virtual void	LightOnL(TInt)
virtual void	LightOnL(TInt, TInt)
virtual void	LightOnL(TInt, TInt, TInt, TBool)
IMPORT_C void	LightOnL(TInt, TInt, const THWRMLightColor &)
IMPORT_C void	LightOnL(TInt, TInt, TInt, TBool, const THWRMLightColor &)
virtual TLightStatus	LightStatus(TInt)
IMPORT_C CHWRMLight *	NewL()
IMPORT_C CHWRMLight *	NewL(MHWRMLightObserver *)
IMPORT_C CHWRMLight *	NewLC()
IMPORT_C CHWRMLight *	NewLC(MHWRMLightObserver *)
virtual void	ReleaseLight(TInt)
virtual void	ReserveLightL(TInt)
virtual void	ReserveLightL(TInt, TBool, TBool)
IMPORT_C void	SetLightColorL(TInt, THWRMLightColor &)
IMPORT_C void	SetLightDefaultColorL(TInt)
virtual TInt	SupportedTargets()

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Detailed Description

The class used to control the device lights.

The HW Resource Manager Light API is a library API providing the ability to control the various light targets of the device. The API provides also methods to retrieve the current light status and the supported light targets of the device. The API is meant for all applications which need to control lights of the device.

Type of the HW Resource Manager Light API is a synchronous method call meaning the method call will block the client application. Every new call of the light API method stops all ongoing light control orders. Light state after duration based orders expire is the state specified by the last non-duration based order.

The API consist of the classes CHWRMLight and MHWRMLightObserver. If the client requires up-to-date status information, it should also provide callback pointer of the MHWRMLightObserver implementing class for the NewL-method.

Usage:

 #include <hwrmlight.h> 

 // A CHWRMLight instance can be created by using NewL() or NewLC() methods. 
 // Up-to-date status information not required, no callbacks.
 CHWRMLight* light = CHWRMLight::NewL();

 // After this, lights can be directly controlled via the provided class methods. 
 light-> LightOnL (EPrimaryDisplay, 5000); // Turn display lights on for five seconds.
 light->LightOffL(EPrimaryDisplay); // Turn display lights off indefinitely.

 // To clean up, delete the created object:
 delete light;

Member Enumeration Documentation

Enum TLightStatus

Possible light states that can be get for the different light targets

Enumerator	Value	Description
ELightStatusUnknown	0	For debugging/development and signaling an error conditions.
ELightOn		Light state switch to light on.
ELightOff		Light state switch to light off.
ELightBlink		Light state switch to light blinking.

Enum TLightTarget

Possible light targets. Targets can be used as bitmask. Some common masks are provided as enum.

Note that all targets are not supported by all devices. Attempting to use unsupported target will result in KErrNotSupported.

At least one target must be defined.

Enumerator	Value	Description
ENoTarget	0x0	No target. Not a valid target value, used only for error checking.
EPrimaryDisplay	0x1	Primary display of the device.
EPrimaryKeyboard	0x2	Primary keyboard of the device.
EPrimaryDisplayAndKeyboard	0x3	Both primary display and the primary keyboard of the device.
ESecondaryDisplay	0x4	Secondary display of the device.
ESecondaryKeyboard	0x8	Secondary keyboard of the device.
ESecondaryDisplayAndKeyboard	0xC	Both secondary display and the secondary keyboard of the device.
ECustomTarget1	0x10	Device specific custom target 1.
ECustomTarget2	0x20	Device specific custom target 2.
ECustomTarget3	0x40	Device specific custom target 3.
ECustomTarget4	0x80	Device specific custom target 4.
ESystemTarget	0x80000000	Special target used to control all currently available system lights. System lights normally include all displays and keyboards, but not custom lights. This is however device dependent. A target mask including this target is always changed to a device state specific target mask. Note that the system target with any other target is not supported. This target is always supported but it is never included in supported targets mask. See also: CHWRMLight::SupportedTargets()

Constructor & Destructor Documentation

~CHWRMLight ( )

IMPORT_C

~CHWRMLight

(

)

Destructor

Member Function Documentation

LightBlinkL ( TInt )

void

LightBlinkL

(

TInt

aTarget

)

[virtual]

The LightBlinkL method blinks the target light(s) of the device for infinite duration using default intensity.

Calling this method is equal to call

 LightBlinkL(aTarget, KHWRMInfiniteDuration, KHWRMDefaultCycleTime, 
             KHWRMDefaultCycleTime, KHWRMDefaultIntensity).

See also: TLightTarget

Parameters
aTarget	Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.

Leave Codes
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightBlinkL ( TInt, TInt )

void	LightBlinkL	(	TInt	aTarget,
			TInt	aDuration
		)	[virtual]

The LightBlinkL method blinks the target light(s) of the device for specified duration using default intensity.

Calling this method is equal to calling LightBlinkL(aTarget, aDuration, KHWRMDefaultCycleTime, KHWRMDefaultCycleTime, KHWRMDefaultIntensity).

See also: TLightTarget

Parameters

aTarget

Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.

aDuration

Duration of the time the light is set to blink measured in milliseconds. After the duration expires, the light state for target will be changed to whatever state was caused by the last infinite time duration call, or default state determined by inactivity timer, in case there has not been a previous infinite time duration call in this session. If the aTotalDuration time is KHWRMInfiniteDuration then it means an infinite value that has to be stopped by calling of any of the other light control methods. Duration can have maximum value of KHWRMLightMaxDuration.

Leave Codes
KErrArgument	Parameter aDuration is out of range.
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightBlinkL ( TInt, TInt, TInt, TInt, TInt )

void	LightBlinkL	(	TInt	aTarget,
			TInt	aDuration,
			TInt	aOnDuration,
			TInt	aOffDuration,
			TInt	aIntensity
		)	[virtual]

The LightBlinkL method blinks the target light(s) of the device for specified duration using specified intensity. On- and Off-cycle times of the blinking can also be controlled.

See also: TLightTarget

Parameters
aTarget	Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.
aDuration	Duration of the time the light is set to blink measured in milliseconds. After the duration expires, the light state for target will be changed to whatever state was caused by the last infinite time duration call, or default state determined by inactivity timer, in case there has not been a previous infinite time duration call in this session. If the aTotalDuration time is KHWRMInfiniteDuration then it means an infinite value that has to be stopped by calling of any of the other light control methods. Duration can have maximum value of KHWRMLightMaxDuration.
aOnDuration	Duration time, measured in milliseconds, of how long the Light is switched on in every Blink cycle. Duration can have maximum value of KHWRMLightMaxDuration. For device default cycle duration, use value KHWRMDefaultCycleTime. If either of aOnDuration or aOffDuration is KHWRMDefaultCycleTime, both must be KHWRMDefaultCycleTime. Some devices might not support variable blink cycle times, in which case default value will be substituted.
aOffDuration	Duration time, measured in milliseconds, of how long the Light is switched off in every Blink cycle. Duration can have maximum value of KHWRMLightMaxDuration. For device default cycle duration, use value KHWRMDefaultCycleTime. If either of aOnDuration or aOffDuration is KHWRMDefaultCycleTime, both must be KHWRMDefaultCycleTime. Some devices might not support variable blink cycle times, in which case default value will be substituted.
aIntensity	Intensity of the light. If aIntensity is KHWRMDefaultIntensity, device default intensity will be used. Note: All devices might not support user defined intensity, in which case device will behave in its default fashion.

Leave Codes
KErrArgument	One of the parameters is out of range or otherwise invalid.
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightBlinkL ( TInt, TInt, const THWRMLightColor & )

IMPORT_C void	LightBlinkL	(	TInt	aTarget,
			TInt	aDuration,
			const THWRMLightColor &	aRGBParam
		)

The LightBlinkL method blinks the target light(s) of the device for specified duration and color using default intensity.

See also: TLightTarget THWRMLightColor

Parameters
aTarget	Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.
aDuration	Duration of the time the light is set to blink measured in milliseconds. After the duration expires, the light state for target will be changed to whatever state was caused by the last infinite time duration call, or default state determined by inactivity timer, in case there has not been a previous infinite time duration call in this session. If the aTotalDuration time is KHWRMInfiniteDuration then it means an infinite value that has to be stopped by calling of any of the other light control methods. Duration can have maximum value of KHWRMLightMaxDuration.
aRGBParam	RGB Values to be set for the target(s).

Leave Codes
KErrArgument	Parameter aDuration is out of range.
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightBlinkL ( TInt, TInt, TInt, TInt, TInt, const THWRMLightColor & )

IMPORT_C void	LightBlinkL	(	TInt	aTarget,
			TInt	aDuration,
			TInt	aOnDuration,
			TInt	aOffDuration,
			TInt	aIntensity,
			const THWRMLightColor &	aRGBParam
		)

The LightBlinkL method blinks the target light(s) of the device for specified duration using specified intensity and color. On- and Off-cycle times of the blinking can also be controlled.

See also: TLightTarget THWRMLightColor

Parameters
aTarget	Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.
aDuration	Duration of the time the light is set to blink measured in milliseconds. After the duration expires, the light state for target will be changed to whatever state was caused by the last infinite time duration call, or default state determined by inactivity timer, in case there has not been a previous infinite time duration call in this session. If the aTotalDuration time is KHWRMInfiniteDuration then it means an infinite value that has to be stopped by calling of any of the other light control methods. Duration can have maximum value of KHWRMLightMaxDuration.
aOnDuration	Duration time, measured in milliseconds, of how long the Light is switched on in every Blink cycle. Duration can have maximum value of KHWRMLightMaxDuration. For device default cycle duration, use value KHWRMDefaultCycleTime. If either of aOnDuration or aOffDuration is KHWRMDefaultCycleTime, both must be KHWRMDefaultCycleTime. Some devices might not support variable blink cycle times, in which case default value will be substituted.
aOffDuration	Duration time, measured in milliseconds, of how long the Light is switched off in every Blink cycle. Duration can have maximum value of KHWRMLightMaxDuration. For device default cycle duration, use value KHWRMDefaultCycleTime. If either of aOnDuration or aOffDuration is KHWRMDefaultCycleTime, both must be KHWRMDefaultCycleTime. Some devices might not support variable blink cycle times, in which case default value will be substituted.
aIntensity	Intensity of the light. If aIntensity is KHWRMDefaultIntensity, device default intensity will be used. Note: All devices might not support user defined intensity, in which case device will behave in its default fashion.
aRGBParam	RGB Values to be set for the target(s).

Leave Codes
KErrArgument	One of the parameters is out of range or otherwise invalid.
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightOffL ( TInt )

void

LightOffL

(

TInt

aTarget

)

[virtual]

The LightOffL method switches the device light off for the specified target for infinite duration. Lights will be switched off with fade-out.

Calling this method is equal to call LightOffL(aTarget, KHWRMInfiniteDuration, ETrue).

See also: TLightTarget

Parameters
aTarget	Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.

Leave Codes
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightOffL ( TInt, TInt )

void	LightOffL	(	TInt	aTarget,
			TInt	aDuration
		)	[virtual]

The LightOffL method switches the device light off for the specified target for the specified duration time. Lights will be switched off with fade-out.

Calling this method is equal to call LightOffL(aTarget, aDuration, ETrue).

See also: TLightTarget

Parameters

aTarget

Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.

aDuration

Duration of the time the light is switched off measured in milliseconds. After the duration expires, the light state for target will be changed to whatever state was caused by the last infinite time duration call, or default state determined by inactivity timer, in case there has not been a previous infinite time duration call in this session. If the aDuration time is KHWRMInfiniteDuration then it means an infinite value that has to be stopped by calling of any of the other light control methods. Duration can have maximum value of KHWRMLightMaxDuration.

Leave Codes
KErrArgument	Parameter aDuration is out of range.
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightOffL ( TInt, TInt, TBool )

void	LightOffL	(	TInt	aTarget,
			TInt	aDuration,
			TBool	aFadeOut
		)	[virtual]

The LightOffL method switches the device light off for the specified target for the specified duration time. Lights fade-out can also be controlled.

See also: TLightTarget

Parameters
aTarget	Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.
aDuration	Duration of the time the light is switched off measured in milliseconds. After the duration expires, the light state for target will be changed to whatever state was caused by the last infinite time duration call, or default state determined by inactivity timer, in case there has not been a previous infinite time duration call in this session. If the aDuration time is KHWRMInfiniteDuration then it means an infinite value that has to be stopped by calling of any of the other light control methods. Duration can have maximum value of KHWRMLightMaxDuration.
aFadeOut	If ETrue, lights will not turn off instantly but instead smoothly fade-out Note: All devices will not support fade-out, in which case device will behave in its default fashion.

Leave Codes
KErrArgument	aDuration is out of range.
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightOnL ( TInt )

void

LightOnL

(

TInt

aTarget

)

[virtual]

The LightOnL method switches the specified target light on for infinite duration using default intensity. Lights will use fade-in.

Calling this method is equal to calling LightOnL(aTarget, KHWRMInfiniteDuration, KHWRMDefaultIntensity, ETrue).

See also: TLightTarget

Parameters
aTarget	Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.

Leave Codes
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightOnL ( TInt, TInt )

void	LightOnL	(	TInt	aTarget,
			TInt	aDuration
		)	[virtual]

The LightOnL method switches the specified target light on for the specified duration using default intensity. Lights will use fade-in.

Calling this method is equal to call LightOnL(aTarget, aDuration, KHWRMDefaultIntensity, ETrue).

See also: TLightTarget

Parameters

aTarget

Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.

aDuration

Duration of the time the light is switched on measured in milliseconds. After the duration expires, the light state for target will be changed to whatever state was caused by the last infinite time duration call, or default state determined by inactivity timer, in case there has not been a previous infinite time duration call in this session. If the aDuration time is KHWRMInfiniteDuration then it means an infinite value that has to be stopped by calling of any of the other ' light control methods. Duration can have maximum value of KHWRMLightMaxDuration.

Leave Codes
KErrArgument	Parameter aDuration is out of range.
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightOnL ( TInt, TInt, TInt, TBool )

void	LightOnL	(	TInt	aTarget,
			TInt	aDuration,
			TInt	aIntensity,
			TBool	aFadeIn
		)	[virtual]

The LightOnL method switches the specified target light on for the specified duration using specified intensity. Fade-in can also be controlled.

See also: TLightTarget

Parameters
aTarget	Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.
aDuration	Duration of the time the light is switched on measured in milliseconds. After the duration expires, the light state for target will be changed to whatever state was caused by the last infinite time duration call, or default state determined by inactivity timer, in case there has not been a previous infinite time duration call in this session. If the aDuration time is KHWRMInfiniteDuration then it means an infinite value that has to be stopped by calling of any of the other light control methods. Duration can have maximum value of KHWRMLightMaxDuration.
aIntensity	Intensity of the light. If aIntensity is KHWRMDefaultIntensity, device default intensity will be used. Note: All devices might not support user defined intensity, in which case device will behave in its default fashion.
aFadeIn	If ETrue, lights will not turn on instantly but instead smoothly fade-in. Note: All devices will not support fade-in, in which case device will behave in its default fashion.

Leave Codes
KErrArgument	One of the parameters is out of range.
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightOnL ( TInt, TInt, const THWRMLightColor & )

IMPORT_C void	LightOnL	(	TInt	aTarget,
			TInt	aDuration,
			const THWRMLightColor &	aRGBParam
		)

The LightOnL method switches the specified target light on for the specified duration and specified color.

See also: TLightTarget THWRMLightColor

Parameters
aTarget	Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.
aDuration	Duration of the time the light is switched on measured in milliseconds. After the duration expires, the light state for target will be changed to whatever state was caused by the last infinite time duration call, or default state determined by inactivity timer, in case there has not been a previous infinite time duration call in this session. If the aDuration time is KHWRMInfiniteDuration then it means an infinite value that has to be stopped by calling of any of the other light control methods. Duration can have maximum value of KHWRMLightMaxDuration.
aRGBParam	RGB Values to be set for the target(s).

Leave Codes
KErrArgument	One of the parameters is out of range.
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightOnL ( TInt, TInt, TInt, TBool, const THWRMLightColor & )

IMPORT_C void	LightOnL	(	TInt	aTarget,
			TInt	aDuration,
			TInt	aIntensity,
			TBool	aFadeIn,
			const THWRMLightColor &	aRGBParam
		)

The LightOnL method switches the specified target light on for the specified duration using specified intensity and color. Fade-in can also be controlled.

See also: TLightTarget THWRMLightColor

Parameters
aTarget	Defines which light should be controlled. Multiple lights can be specified with using bitwise-or.
aDuration	Duration of the time the light is switched on measured in milliseconds. After the duration expires, the light state for target will be changed to whatever state was caused by the last infinite time duration call, or default state determined by inactivity timer, in case there has not been a previous infinite time duration call in this session. If the aDuration time is KHWRMInfiniteDuration then it means an infinite value that has to be stopped by calling of any of the other light control methods. Duration can have maximum value of KHWRMLightMaxDuration.
aIntensity	Intensity of the light. If aIntensity is KHWRMDefaultIntensity, device default intensity will be used. Note: All devices might not support user defined intensity, in which case device will behave in its default fashion.
aFadeIn	If ETrue, lights will not turn on instantly but instead smoothly fade-in. Note: All devices will not support fade-in, in which case device will behave in its default fashion.
aRGBParam	RGB Values to be set for the target(s).

Leave Codes
KErrArgument	One of the parameters is out of range.
KErrNotSupported	One or more of specified targets are not supported.
KErrBadHandle	Light session has been invalidated.
KErrTimedOut	Timeout occurred in controlling light.
KErrInUse	One or more of specified targets are not reserved for this client but are reserved for others.
KErrNoMemory	There is a memory allocation failure.
KErrGeneral	There is a hardware error.

LightStatus ( TInt )

TLightStatus

LightStatus

(

TInt

aTarget

)

const [virtual]

This method retrieves the current light status.

Parameters
aTarget	Defines which light status is returned. This method only supports single target, as different targets might have different statuses.

Return Value: TLightStatus indicating the current light status. If there is a problem or multiple targets were specified, CHWRMLight::ELightStatusUnknown is returned.

NewL ( )

IMPORT_C CHWRMLight *

NewL

(

)

[static]

Two-phased constructor.

Return Value: A pointer to a new instance of the CHWRMLight class.

Leave Codes
KErrNotSupported	Device doesn't support Light feature.
KErrNoMemory	There is a memory allocation failure.

NewL ( MHWRMLightObserver * )

IMPORT_C CHWRMLight *

NewL

(

MHWRMLightObserver *

aCallback

)

[static]

Two-phased constructor. Use this method for creating a Light client with callbacks.

Parameters
aCallback	Pointer to the callback instance.

Return Value: A pointer to a new instance of the CHWRMLight class.

Leave Codes
KErrNotSupported	Device doesn't support Light feature.
KErrNoMemory	There is a memory allocation failure.

NewLC ( )

IMPORT_C CHWRMLight *

NewLC

(

)

[static]

Two-phased constructor. Leaves instance to cleanup stack.

Return Value: A pointer to a new instance of the CHWRMLight class.

Leave Codes
KErrNotSupported	Device doesn't support Light feature.
KErrNoMemory	There is a memory allocation failure.

NewLC ( MHWRMLightObserver * )

IMPORT_C CHWRMLight *

NewLC

(

MHWRMLightObserver *

aCallback

)

[static]

Two-phased constructor. Use this method for creating a Light client with callbacks. Leaves instance to cleanup stack.

Parameters
aCallback	Pointer to the callback instance

Return Value: A pointer to a new instance of the CHWRMLight class.

Leave Codes
KErrNotSupported	Device doesn't support Light feature.
KErrNoMemory	There is a memory allocation failure.

ReleaseLight ( TInt )

void

ReleaseLight

(

TInt

aTarget

)

[virtual]

Releases light target if it was previously reserved for this client. If this client has not reserved any of the specified lights, this method does nothing. Any reserved light targets that are released and have no other suspended clients will be reset to default state, which is either lights on or lights off, depending on system inactivity time.

See also: TLightTarget

Parameters
aTarget	Defines which light should be released. Multiple lights can be specified with using bitwise-or.

ReserveLightL ( TInt )

void

ReserveLightL

(

TInt

aTarget

)

[virtual]

Reserves light target exclusively for this client. A higher priority client may cause lower priority client reservation to be temporarily suspended. Commands can still be issued in suspended state, but they will not be acted upon unless suspension is lifted within specified duration. The suspended client will not get any notification about suspension. If light target is already reserved by a higher or equal priority application, reserving will still succeeds, but reservation is immediately suspended.

Calling this method is equal to calling ReserveLightL( aTarget, EFalse, EFalse), i.e. any previously frozen state will not be restored and CCoeEnv background/foreground status is always used to control further reservations.

See also: TLightTarget

Parameters
aTarget	Defines which light should be reserved. Multiple lights can be specified with using bitwise-or.

Leave Codes
KErrNotSupported	One or more of specified targets are not supported.
KErrAccessDenied	No CCoeEnv present.
KErrNotReady	Trying to reserve while on background.
KErrNoMemory	There is a memory allocation failure.

ReserveLightL ( TInt, TBool, TBool )

void	ReserveLightL	(	TInt	aTarget,
			TBool	aRestoreState,
			TBool	aForceNoCCoeEnv
		)	[virtual]

See also: TLightTarget

Parameters
aTarget	Defines which light should be reserved. Multiple lights can be specified with using bitwise-or.
aRestoreState	If ETrue, the state frozen on last release will be restored upon successful reservation. I.e. if light was blinking when it was released by this client the last time, it would start blinking again upon successful reservation. For the first reservation of each session this parameter is always considered EFalse regardless of what is supplied, as there is no previous frozen state to restore.
aForceNoCCoeEnv	If EFalse, then reservation requires that this client is on the foreground at the time of reservation and light target will be automatically released and re-reserved based on background/foreground status of the this client. This also implies that CCoeEnv::Static() != NULL is required. If ETrue, the client will not require CCoeEnv to be present nor does it automatically reserve/release light by depending on foreground/background status of the client. Only trusted clients are allowed to set this flag to ETrue. A client is considered trusted if it has nonstandard priority defined in the internal lights policy of the HW Resource Manager. A client can be defined trusted only by a product.

Leave Codes
KErrNotSupported	One or more of specified targets are not supported.
KErrAccessDenied	Paramenter aForceNoCCoeEnv is ETrue and client is not trusted.
KErrBadHandle	Parameter ForceNoCCoeEnv is EFalse and no CCoeEnv present.
KErrNotReady	Trying to reserve while on background and parameter aForceNoCCoeEnv is EFalse.
KErrNoMemory	There is a memory allocation failure.

SetLightColorL ( TInt, THWRMLightColor & )

IMPORT_C void	SetLightColorL	(	TInt	aTarget,
			THWRMLightColor &	aRGB
		)

SetLightDefaultColorL ( TInt )

IMPORT_C void

SetLightDefaultColorL

(

TInt

aTarget

)

SupportedTargets ( )

TInt

SupportedTargets

(

)

const [virtual]

This method retrieves the supported light targets of the device. Any attempt to use or reserve unsupported targets will fail with KErrNotSupported.

See also: TLightTarget

Return Value: Bitmask containing supported light targets.