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.