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 |