Reserving the device vibra

The ReserveVibraL() call reserves the vibration feature exclusively for the 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 are not acted upon unless suspension is lifted within specified duration. The suspended client does not receive any notification about suspension. If vibra is already reserved by a higher or equal priority application, reserving still succeeds but suspended immediately.

The following code snippet demonstrates how to reserve the device vibration feature:

iVibra->ReserveVibraL( ETrue, EFalse );

First parameter ETrue means that any previously frozen state is restored. Second parameter EFalse means that the CCoeEnv background/foreground status is always used to control further reservations.

Calling the ReserveVibraL() method without parameters is equal to calling ReserveVibraL(EFalse, EFalse), i.e. any previously frozen state is not restored and the CCoeEnv background/foreground status is always used to control further reservations.