Symbian3/SDK/Source/GUID-DD8BFFF1-15C7-59B0-A107-C5CC90DBF4CC.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Tue, 20 Jul 2010 12:00:49 +0100
changeset 13 48780e181b38
parent 7 51a74ef9ed63
permissions -rw-r--r--
Week 28 contribution of SDK documentation content. See release notes for details. Fixes bugs Bug 1897 and Bug 1522.

<?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-DD8BFFF1-15C7-59B0-A107-C5CC90DBF4CC" xml:lang="en"><title>Pausing
and Resuming a Tone </title><shortdesc>The <codeph>CMMFDevSound::Pause()</codeph> function pauses the
play tone state. If the <codeph>CMMFDevSound::Resume()</codeph> function is
supported, you can then use it to continue playing.</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
<context id="GUID-A4AE887E-00E7-4F51-A98B-06E170C7B404"><p>You can pause and resume tones played by calling any of the following
functions:</p><ul>
<li><p><xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-0849016F-D457-3521-A53A-85023D8561B8"><apiname>CMMFDevSound::PlayToneL(TInt,const TTimeIntervalMicroSeconds
&amp;)</apiname></xref> plays a single tone. </p></li>
<li><p><xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-D2C197B2-BB55-3B46-8F4D-FEDEE846B166"><apiname>CMMFDevSound::PlayDualToneL(TInt,TInt,const TTimeIntervalMicroSeconds
&amp;)</apiname></xref> plays a dual tone. </p></li>
<li><p><xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-3E9E0095-DC9A-3ABF-90E9-1B2ED469BBC4"><apiname>CMMFDevSound::PlayDTMFStringL(const TDesC &amp;)</apiname></xref> plays
a DTMF (Dual and Multi-Frequency) tone </p></li>
<li><p><xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-2B48CD01-DBD9-3669-8F79-0812FA03B0D3"><apiname>CMMFDevSound::PlayToneSequenceL(const TDesC8 &amp;)</apiname></xref> plays
a sequence of tones. </p></li>
</ul></context>
<steps id="GUID-2D5F15E0-975D-5CF3-BB5D-60F108B0B48E">
<step id="GUID-8F0EEDE1-9C9C-5C53-A359-33505C11D51C"><cmd>Check that the <codeph>Resume()</codeph> function
is supported using the <xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-FF81EF26-C315-395C-99EC-CE54B4FFCAA4"><apiname>CMMFDevSound::IsResumeSupported()</apiname></xref> function.</cmd>
</step>
<step id="GUID-73852361-98B0-533C-AB9C-27D946707C6B"><cmd>If the resume function
is supported, call the <xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-D9C071E1-9F7D-39C5-8B6E-34321A46D3A9"><apiname>CMMFDevSound::Pause()</apiname></xref> function to
pause the tone.</cmd>
</step>
<step id="GUID-8917B5C6-0176-573F-9A3E-64E89AB3632A"><cmd>Call the <xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-263CCA90-A3AA-31A0-A62B-795E5F988A17"><apiname>CMMFDevSound::Resume()</apiname></xref> function
to continue playing the tone. </cmd>
</step>
</steps>
</taskbody><related-links>
<link href="GUID-14BAAB7C-35CD-5A43-B362-79F88C7712DE.dita"><linktext>Playing a
Tone</linktext></link>
<link href="GUID-3AB05112-0580-5FD2-AD61-5721090062F8.dita"><linktext>Playing a
DTMF                 Tone</linktext></link>
<link href="GUID-93EF4862-2395-5ED7-8446-A7FDA60535B1.dita"><linktext>Playing a
Fixed                 Tone</linktext></link>
<link href="GUID-12A754EE-7D90-56C8-BDA7-3293F34BE456.dita"><linktext>Playing a
Tone                 Sequence</linktext></link>
</related-links></task>