Skip to content

Latest commit

 

History

History
121 lines (94 loc) · 3.89 KB

nf-audioclient-iaudioclient-stop.md

File metadata and controls

121 lines (94 loc) · 3.89 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:audioclient.IAudioClient.Stop
IAudioClient::Stop (audioclient.h)
The Stop method stops the audio stream.
IAudioClient interface [Core Audio]
Stop method
IAudioClient.Stop
IAudioClient::Stop
IAudioClientStop
Stop
Stop method [Core Audio]
Stop method [Core Audio]
IAudioClient interface
audioclient/IAudioClient::Stop
coreaudio.iaudioclient_stop
coreaudio\iaudioclient_stop.htm
CoreAudio
d5824aa9-0b91-4bee-9c0c-26e12a6b96b5
12/05/2018
IAudioClient interface [Core Audio],Stop method, IAudioClient.Stop, IAudioClient::Stop, IAudioClientStop, Stop, Stop method [Core Audio], Stop method [Core Audio],IAudioClient interface, audioclient/IAudioClient::Stop, coreaudio.iaudioclient_stop
audioclient.h
Windows
Windows Vista [desktop apps \| UWP apps]
Windows Server 2008 [desktop apps \| UWP apps]
Windows
19H1
IAudioClient::Stop
audioclient/IAudioClient::Stop
c++
APIRef
kbSyntax
COM
Audioclient.h
IAudioClient.Stop

IAudioClient::Stop

-description

The Stop method stops the audio stream.

-returns

If the method succeeds and stops the stream, it returns S_OK. If the method succeeds and the stream was already stopped, the method returns S_FALSE. If it fails, possible return codes include, but are not limited to, the values shown in the following table.

Return code Description
AUDCLNT_E_NOT_INITIALIZED
The client has not been successfully initialized.
AUDCLNT_E_SERVICE_NOT_RUNNING
The Windows audio service is not running.

-remarks

This method requires prior initialization of the IAudioClient interface. All calls to this method will fail with the error AUDCLNT_E_NOT_INITIALIZED until the client initializes the audio stream by successfully calling the IAudioClient::Initialize method.

Stop is a control method that stops a running audio stream. This method stops data from streaming through the client's connection with the audio engine. Stopping the stream freezes the stream's audio clock at its current stream position. A subsequent call to IAudioClient::Start causes the stream to resume running from that position. If necessary, the client can call the IAudioClient::Reset method to reset the position while the stream is stopped.

For code examples that call the Stop method, see the following topics:

-see-also

IAudioClient Interface

IAudioClient::Initialize

IAudioClient::Reset

IAudioClient::Start