IAudioClient::Reset 方法 (audioclient.h)

Reset 方法重置音频流。

语法

HRESULT Reset();

返回值

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

返回代码 说明
AUDCLNT_E_NOT_INITIALIZED
音频流尚未成功初始化。
AUDCLNT_E_NOT_STOPPED
进行呼叫时,音频流未停止。
AUDCLNT_E_BUFFER_OPERATION_PENDING
客户端当前正在向缓冲区写入或读取缓冲区。
AUDCLNT_E_SERVICE_NOT_RUNNING
Windows 音频服务未运行。

注解

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

Reset 是客户端调用的一种控制方法,用于重置已停止的音频流。 重置流会刷新所有挂起的数据,并将音频时钟流位置重置为 0。 如果在未停止的流上调用此方法,则此方法失败。

要求

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

另请参阅

IAudioClient 接口

IAudioClient::Initialize