ISpatialAudioObjectRenderStreamBase::Reset 方法 (spatialaudioclient.h)

重置已停止的音频流。

语法

HRESULT Reset();

返回值

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

返回代码 说明
SPTLAUDCLNT_E_STREAM_NOT_STOPPED
音频流尚未停止。 通过调用 Stop 停止流。
SPTLAUDCLNT_E_DESTROYED
与空间音频流关联的 ISpatialAudioClient 已销毁。
AUDCLNT_E_DEVICE_INVALIDATED
音频终结点设备已拔出,或者音频硬件或关联的硬件资源已重新配置、禁用、删除或以其他方式不可用。
SPTLAUDCLNT_E_INTERNAL
发生了内部错误。
AUDCLNT_E_UNSUPPORTED_FORMAT
与空间音频流关联的媒体使用不受支持的格式。

注解

重置音频流会刷新所有挂起的数据,并将音频时钟流位置重置为 0。 重置流还会导致撤销所有活动的 ISpatialAudioObject 实例。
Start 的后续调用会导致流从 0 位置开始。

流之前必须已通过调用 Stop 停止,否则方法将失败并返回SPTLAUDCLNT_E_STREAM_NOT_STOPPED。

要求

要求
目标平台 Windows
标头 spatialaudioclient.h

另请参阅

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase