IXAudio2SourceVoice::SetSourceSampleRate 方法 (xaudio2.h)
重新設定語音,以與建立語音時所指定的速率不同的取樣率取用源數據。
語法
HRESULT SetSourceSampleRate(
[in] UINT32 NewSourceSampleRate
);
參數
[in] NewSourceSampleRate
語音應該處理提交數據的新取樣率。 有效的取樣速率為 1kHz 到 200kHz。
傳回值
如果成功,則傳回S_OK,否則傳回錯誤碼。 如需錯誤碼的描述,請參閱 XAudio2 錯誤 碼。
備註
SetSourceSampleRate 方法支援重複使用 XAudio2 語音,方法是允許語音以各種取樣率播放音效。 若要使用 SetSourceSampleRate ,必須建立語音,而不需使用XAUDIO2_VOICE_NOPITCH或XAUDIO2_VOICE_NOSRC旗標,且不得有任何目前排入佇列的緩衝區。
SetSourceSampleRate 的一般用法是支援語音共用。 例如,若要支援語音共享,應用程式會預先建立預期使用的所有語音。 每當播放新的音效時,應用程式就會選擇非使用中的語音,或者,如果所有聲音都忙碌中,請挑選最不重要的語音,並以新音效的取樣率呼叫 SetSourceSampleRate 。 在語音上呼叫 SetSourceSampleRate 之後,應用程式就可以立即開始以新的取樣率提交和播放緩衝區。 這可讓應用程式避免在遊戲期間經常建立和終結語音的額外負荷。
平臺需求
Windows 10 (XAudio2.9) ;Windows 8,Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | xaudio2.h |