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