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