(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