共用方式為

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

另請參閱

IXAudio2SourceVoice