1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE task

    11   PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

    12 <task id="GUID-F575F364-4BCA-42C7-BE00-7B31D8B55AE1" xml:lang="en"><title>Reserving

    13 the device vibra</title><prolog><metadata><keywords/></metadata></prolog><taskbody>

    14 <context>       <p>The <codeph>ReserveVibraL()</codeph> call reserves the

    15 vibration feature exclusively for the client. A higher priority client may

    16 cause lower priority client reservation to be temporarily suspended. Commands

    17 can still be issued in suspended state, but they are not acted upon unless

    18 suspension is lifted within specified duration. The suspended client does

    19 not receive any notification about suspension. If vibra is already reserved

    20 by a higher or equal priority application, reserving still succeeds but suspended

    21 immediately.</p><p>The following code snippet demonstrates how to reserve

    22 the device vibration feature:</p><codeblock xml:space="preserve">iVibra-&gt;ReserveVibraL( ETrue, EFalse );</codeblock><p>First

    23 parameter <codeph>ETrue</codeph> means that any previously frozen state is

    24 restored. Second parameter <codeph>EFalse</codeph> means that the <codeph>CCoeEnv</codeph> background/foreground

    25 status is always used to control further reservations.</p><p>Calling the <codeph>ReserveVibraL()</codeph> method

    26 without parameters is equal to calling <codeph>ReserveVibraL(EFalse, EFalse)</codeph>,

    27 i.e. any previously frozen state is not restored and the <codeph>CCoeEnv</codeph> background/foreground

    28 status is always used to control further reservations. </p></context>

    29 </taskbody></task>