Метод IXAudio2VoiceCallback::OnBufferStart (xaudio2.h)

Статья
08/28/2023

Вызывается, когда голос начинает обработку нового звукового буфера.

Синтаксис

void OnBufferStart(
  void *pBufferContext
);

Параметры

pBufferContext

Указатель контекста, назначенный элементу pContext структуры XAUDIO2_BUFFER при отправке буфера.

Возвращаемое значение

None

Remarks

pBufferContext — это указатель контекста, изначально предоставленный элементом pContextструктуры XAUDIO2_BUFFER , который может иметь значение NULL.

OnBufferStart гарантированно вызывается непосредственно перед использованием первого байта текущего буфера. Этот обратный вызов рекомендуется использовать для изменения состояния голоса, например следующего.

Отправка нового буфера в голос
Настройка параметров громкости, тона и эффекта голоса
Включение или отключение эффекта в цепочке эффектов голоса

Все перечисленные выше действия синхронны при обратном вызове XAudio2, поэтому изменения вступают в силу немедленно, затрагивая буфер, который вот-вот запустится.

Этот обратный вызов также можно использовать для записи звуковых данных в буфер напрямую, что может быть полезно в сценариях потоковой передачи с низкой задержкой. Однако, как и в случае со всеми обратными вызовами XAudio2, не следует выполнять никаких действий, которые используют значительное время процессора или могут блокировать выполнение, включая синхронные операции чтения диска или сети.

Сведения о методах интерфейса IXAudio2VoiceCallback см. в разделе Обратные вызовы XAudio2 .

Требования к платформе

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); Пакет SDK Для DirectX (XAudio 2.7)

Требования

Требование	Значение
Целевая платформа	Windows
Header	xaudio2.h

См. также раздел

Руководство: использование обратных вызовов речевых источников

IXAudio2VoiceCallback

Обратные вызовы в XAudio2

Поделиться через