共用方式為


(audioclient.h) 的 IAudioClient::Reset 方法

Reset 方法會重設音訊數據流。

Syntax

HRESULT Reset();

傳回值

如果方法成功,它會傳回 S_OK。 如果方法成功且數據流已重設,方法會傳回S_FALSE。 如果失敗,可能的傳回碼包括但不限於下表所示的值。

傳回碼 Description
AUDCLNT_E_NOT_INITIALIZED
音訊數據流尚未成功初始化。
AUDCLNT_E_NOT_STOPPED
在進行通話時,音訊數據流並未停止。
AUDCLNT_E_BUFFER_OPERATION_PENDING
用戶端目前正在寫入緩衝區或從緩衝區讀取。
AUDCLNT_E_SERVICE_NOT_RUNNING
Windows 音訊服務未執行。

備註

這個方法需要 IAudioClient 介面的先前初始化。 此方法的所有呼叫都會失敗,併發生錯誤AUDCLNT_E_NOT_INITIALIZED,直到用戶端成功呼叫 IAudioClient::Initialize 方法來初始化音頻數據流為止。

Reset 是用戶端呼叫以重設已停止音訊數據流的控制方法。 重設數據流會排清所有擱置的數據,並將音訊時鐘數據流位置重設為 0。 如果在未停止的數據流上呼叫此方法,此方法就會失敗。

規格需求

需求
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 audioclient.h

另請參閱

IAudioClient 介面

IAudioClient::Initialize