Symbian3/PDK/Source/GUID-F575F364-4BCA-42C7-BE00-7B31D8B55AE1.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Thu, 11 Mar 2010 18:02:22 +0000
changeset 3 46218c8b8afa
parent 1 25a17d01db0c
child 5 f345bda72bc4
permissions -rw-r--r--
week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE task
  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="GUID-F575F364-4BCA-42C7-BE00-7B31D8B55AE1" xml:lang="en"><title>Reserving
the device vibra</title><prolog><metadata><keywords/></metadata></prolog><taskbody>
<context>       <p>The <codeph>ReserveVibraL()</codeph> 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.</p><p>The following code snippet demonstrates how to reserve
the device vibration feature:</p><codeblock xml:space="preserve">iVibra-&gt;ReserveVibraL( ETrue, EFalse );</codeblock><p>First
parameter <codeph>ETrue</codeph> means that any previously frozen state is
restored. Second parameter <codeph>EFalse</codeph> means that the <codeph>CCoeEnv</codeph> background/foreground
status is always used to control further reservations.</p><p>Calling the <codeph>ReserveVibraL()</codeph> method
without parameters is equal to calling <codeph>ReserveVibraL(EFalse, EFalse)</codeph>,
i.e. any previously frozen state is not restored and the <codeph>CCoeEnv</codeph> background/foreground
status is always used to control further reservations. </p></context>
</taskbody></task>