Symbian3/SDK/Source/GUID-A5B74E5C-A26F-5699-8885-3C7F3121FAD6.dita
changeset 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-A5B74E5C-A26F-5699-8885-3C7F3121FAD6.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,13 @@
+<?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-A5B74E5C-A26F-5699-8885-3C7F3121FAD6"><title>Stopping Audio Play </title><shortdesc>This tutorial describes how to stop the audio that is currently being played. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody><steps-unordered id="GUID-F867187D-2989-5992-BF43-6ECEAEDD3F56"><step id="GUID-17DB69D2-ADB6-54BB-AFB6-FC4377BD9723"><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 the playing audio. </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-30349572-DFF6-380B-97A1-3549E00B8259"><apiname>CMMFDevSound::PlayData()</apiname></xref> call or after the <xref href="GUID-D0F3F385-68C9-331D-865F-DA36589BE9FD.dita#GUID-D0F3F385-68C9-331D-865F-DA36589BE9FD/GUID-FBB7A51D-771C-3820-80A6-1297F98CDCFF"><apiname>MDevSoundObserver::BufferToBeFilled()</apiname></xref> callback. </info> <info> Note: After calling <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>, the client should not call <xref href="GUID-978C8C5A-CA6E-3453-B700-12DE154C1F60.dita"><apiname>PlayData()</apiname></xref> for any outstanding <xref href="GUID-D0F3F385-68C9-331D-865F-DA36589BE9FD.dita#GUID-D0F3F385-68C9-331D-865F-DA36589BE9FD/GUID-FBB7A51D-771C-3820-80A6-1297F98CDCFF"><apiname>MDevSoundObserver::BufferToBeFilled()</apiname></xref> callbacks as they will be ignored. The client should not attempt to write any data into the buffer after the call to <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> as the buffer may no longer be valid. </info> </step> </steps-unordered> </taskbody><related-links><link href="GUID-8CCA6352-DC3D-5BFE-9AAF-B70173DF2558.dita"><linktext>Starting Audio
+                Play</linktext> </link> </related-links></task>
\ No newline at end of file