Symbian3/SDK/Source/GUID-D67D6147-ECE1-576C-A64C-120F32AE2AA2.dita
author Graeme Price <GRAEME.PRICE@NOKIA.COM>
Fri, 15 Oct 2010 14:32:18 +0100
changeset 15 307f4279f433
parent 0 89d6a7a84779
permissions -rw-r--r--
Initial contribution of the Adaptation Documentation.

<?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 xml:lang="en" id="GUID-D67D6147-ECE1-576C-A64C-120F32AE2AA2"><title>Stopping Audio Record </title><shortdesc>This section describes how to use the DevSound library while stopping the audio record functionality. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody><steps-unordered id="GUID-05564451-1E97-531C-BF23-EE184582C2C2"><step id="GUID-04EE1232-B992-5260-9451-88E7CF1D5BB8"><cmd/><info>Call the <xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-D135FACF-07B2-377D-9FF6-6C3B47628897"><apiname>CMMFDevSound::Stop()</apiname></xref> function to stop audio that is currently being recorded. </info> <info>The <codeph>CMMFDevSound::Stop()</codeph> can occur either after the <xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-C6E50479-4E8F-33EE-B298-C5D8DE7E3879"><apiname>CMMFDevSound::RecordData()</apiname></xref> call or after the <xref href="GUID-D0F3F385-68C9-331D-865F-DA36589BE9FD.dita#GUID-D0F3F385-68C9-331D-865F-DA36589BE9FD/GUID-0E4EB9DB-B802-3CE0-979A-F41767BFD017"><apiname>MDevSoundObserver::BufferToBeEmptied()</apiname></xref> callback. </info> <info> Note: The client must call <codeph>CMMFDevSound::RecordData()</codeph> once for each <codeph>MDevSoundObserver::BufferToBeEmptied()</codeph> callback. A <codeph>CMMFDevSound::Stop()</codeph> call is always preceded by a <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> call, the recording cycle then continues until a zero length buffer is returned in the <codeph>MDevSoundObserver::BufferToBeEmptied()</codeph> call, after which the <codeph>CMMFDevSound::Stop()</codeph> call is made. </info> </step> </steps-unordered> </taskbody><related-links><link href="GUID-769CD1E7-8545-5223-A195-43E72AAF5DDC.dita"><linktext>Starting Audio
                Record</linktext> </link> </related-links></task>