共用方式為


IXAudio2Voice::D estroyVoice 方法 (xaudio2.h)

終結語音。 如有必要,請停止語音,並將它從 XAudio2 圖表中移除。

Syntax

\\ void DestroyVoice();

傳回值

這個方法不會傳回值。

備註

如果任何其他語音目前正在將音訊傳送至此語音,此方法就會失敗。

DestroyVoice 會等候音訊處理線程閑置,因此通常需要一些時間 (通常不超過幾毫秒) 。 這是保證語音將不再進行任何回呼或讀取任何音訊數據,因此應用程式可以在呼叫傳回時安全地釋放這些資源。

若要避免封鎖 DestroyVoice 呼叫的標題線程中斷,應用程式可以在個別的非關鍵線程上終結語音,或者應用程式可以使用語音共用策略來重複使用語音,而不是終結語音。 請注意,語音只能與具有相同數據格式的音訊重複使用,以及建立語音所使用的相同頻道數目。 語音可以透過使用適當比例參數呼叫 IXAudio2SourceVoice::SetFrequencyRatio ,以不同的取樣率播放音訊數據。

從回呼 (呼叫 DestroyVoice 無效,也就是 IXAudio2EngineCallbackIXAudio2VoiceCallback) 。

平臺需求

Windows 10 (XAudio2.9) ;Windows 8,Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)

規格需求

需求
目標平台 Windows
標頭 xaudio2.h

另請參閱

IXAudio2Voice