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