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

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

Syntax

\\ void DestroyVoice();

傳回值

這個方法不會傳回值。

備註

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

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

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

從回呼 (呼叫 DestroyVoice 無效，也就是 IXAudio2EngineCallback 或 IXAudio2VoiceCallback) 。

平臺需求

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

規格需求

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

另請參閱

IXAudio2Voice