共用方式為


IAudioClient::Stop 方法 (audioclient.h)

Stop 方法會停止音訊數據流。

Syntax

HRESULT Stop();

傳回值

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

傳回碼 Description
AUDCLNT_E_NOT_INITIALIZED
用戶端尚未成功初始化。
AUDCLNT_E_SERVICE_NOT_RUNNING
Windows 音訊服務未執行。

備註

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

Stop 是停止執行中音訊數據流的控制項方法。 這個方法會阻止數據透過用戶端與音訊引擎的連線進行串流處理。 停止數據流會在數據流目前串流位置凍結數據流的音訊時鐘。 後續呼叫 IAudioClient::Start 會導致數據流繼續從該位置執行。 如有必要,用戶端可以呼叫 IAudioClient::Reset 方法,以在數據流停止時重設位置。

如需呼叫 Stop 方法的程式代碼範例,請參閱下列主題:

規格需求

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

另請參閱

IAudioClient 介面

IAudioClient::Initialize

IAudioClient::Reset

IAudioClient::Start