共用方式為


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 回呼