IAudioClient::Stop 方法 (audioclient.h)

Stop 方法停止音频流。

语法

HRESULT Stop();

返回值

如果 方法成功并停止流,则返回S_OK。 如果方法成功且流已停止,则该方法返回S_FALSE。 如果失败,可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
AUDCLNT_E_NOT_INITIALIZED
客户端尚未成功初始化。
AUDCLNT_E_SERVICE_NOT_RUNNING
Windows 音频服务未运行。

注解

此方法需要事先初始化 IAudioClient 接口。 在客户端通过成功调用 IAudioClient::Initialize 方法初始化音频流之前,对此方法的所有调用都将失败并出现错误AUDCLNT_E_NOT_INITIALIZED。

Stop 是一种控制方法,用于停止正在运行的音频流。 此方法通过客户端与音频引擎的连接阻止数据流式传输。 停止流会将流的音频时钟冻结在其当前流位置。 后续调用 IAudioClient::Start 会导致流从该位置恢复运行。 如有必要,客户端可以调用 IAudioClient::Reset 方法,以在流停止时重置位置。

有关调用 Stop 方法的代码示例,请参阅以下主题:

要求

要求
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 audioclient.h

另请参阅

IAudioClient 接口

IAudioClient::Initialize

IAudioClient::Reset

IAudioClient::Start