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