IAudioClient::Reset 方法 (audioclient.h)
Reset 方法重置音频流。
语法
HRESULT Reset();
返回值
如果该方法成功,则它会返回 S_OK。 如果方法成功且流已重置,则该方法返回S_FALSE。 如果失败,可能的返回代码包括但不限于下表中显示的值。
返回代码 | 说明 |
---|---|
|
音频流尚未成功初始化。 |
|
进行呼叫时,音频流未停止。 |
|
客户端当前正在向缓冲区写入或读取缓冲区。 |
|
Windows 音频服务未运行。 |
注解
此方法需要事先初始化 IAudioClient 接口。 在客户端通过成功调用 IAudioClient::Initialize 方法初始化音频流之前,对此方法的所有调用都将失败并出现错误AUDCLNT_E_NOT_INITIALIZED。
Reset 是客户端调用的一种控制方法,用于重置已停止的音频流。 重置流会刷新所有挂起的数据,并将音频时钟流位置重置为 0。 如果在未停止的流上调用此方法,则此方法失败。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | audioclient.h |