IAudioClient::Stop 方法 (audioclient.h)
Stop 方法會停止音訊數據流。
Syntax
HRESULT Stop();
傳回值
如果方法成功並停止數據流,則會傳回S_OK。 如果方法成功且數據流已經停止,則方法會傳回S_FALSE。 如果失敗,可能的傳回碼包括,但不限於下表所示的值。
傳回碼 | Description |
---|---|
|
用戶端尚未成功初始化。 |
|
Windows 音訊服務未執行。 |
備註
這個方法需要先初始化 IAudioClient 介面。 所有對此方法的呼叫都會失敗,併發生錯誤AUDCLNT_E_NOT_INITIALIZED,直到用戶端成功呼叫 IAudioClient::Initialize 方法來初始化音頻數據流為止。
Stop 是停止執行中音訊數據流的控制項方法。 這個方法會阻止數據透過用戶端與音訊引擎的連線進行串流處理。 停止數據流會在數據流目前串流位置凍結數據流的音訊時鐘。 後續呼叫 IAudioClient::Start 會導致數據流繼續從該位置執行。 如有必要,用戶端可以呼叫 IAudioClient::Reset 方法,以在數據流停止時重設位置。
如需呼叫 Stop 方法的程式代碼範例,請參閱下列主題:
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | audioclient.h |