IXAudio2VoiceCallback::OnBufferStart メソッド (xaudio2.h)

音声が新しいオーディオ バッファーの処理を開始しようとしているときに呼び出されます。

構文

void OnBufferStart(
  void *pBufferContext
);

パラメーター

pBufferContext

バッファーの送信時に 、XAUDIO2_BUFFER 構造体の pContext メンバーに割り当てられたコンテキスト ポインター。

戻り値

なし

解説

pBufferContext は、XAUDIO2_BUFFER構造体の pContext メンバーによって最初に提供されたコンテキスト ポインターです。これは NULL である可能性があります。

OnBufferStart は、現在のバッファーの最初のバイトが使用される直前に呼び出されることを保証します。 次のような音声状態の変更には、このコールバックを使用するのが適切です。

  • 新しいバッファーを音声に送信する
  • 音声の音量、ピッチ、効果のパラメータを調整する
  • 音声のエフェクト チェーンで効果を有効または無効にする
上記のすべてのアクションは、XAudio2 コールバックで実行すると同期されるため、変更はすぐに有効になり、開始しようとしているバッファーに影響します。

また、このコールバックを使用してオーディオ データをバッファーに直接書き込むこともできます。これは、待機時間の短いストリーミング シナリオに役立ちます。 ただし、すべての XAudio2 コールバックと同様に、大量のプロセッサ時間を使用したり、同期ディスクやネットワーク読み取りを含む実行をブロックしたりする作業は行う必要はありません。

IXAudio2VoiceCallback インターフェイス メソッドの詳細については、「XAudio2 コールバック」セクションを参照してください。

プラットフォームの要件

Windows 10 (XAudio2.9);Windows 8、Windows Phone 8 (XAudio 2.8);DirectX SDK (XAudio 2.7)

要件

要件
対象プラットフォーム Windows
ヘッダー xaudio2.h

こちらもご覧ください

方法: ソース ボイスのコールバックの使用

IXAudio2VoiceCallback

XAudio2 のコールバック