Интерфейс IXAudio2VoiceCallback (xaudio2.h)

Интерфейс IXAudio2VoiceCallback содержит методы, которые уведомляют клиента, когда в заданном объекте IXAudio2SourceVoice происходят определенные события.

Этот интерфейс должен быть реализован клиентом XAudio2. XAudio2 вызывает эти методы с помощью указателя интерфейса, предоставленного клиентом в методе IXAudio2::CreateSourceVoice . Методы в этом интерфейсе возвращают void, а не HRESULT.

Ограничения на реализацию обратных вызовов см. в разделе Обратные вызовы XAudio2 .

Метод	Описание
OnBufferEnd	Вызывается, когда голос завершает обработку буфера.
OnBufferStart	Вызывается, когда голос вот-вот начнет обработку нового звукового буфера.
OnLoopEnd	Вызывается, когда голос достигает конечной позиции цикла.
OnStreamEnd	Вызывается, когда голос только что закончил воспроизведение непрерывного аудиопотока.
OnVoiceError	Вызывается при возникновении критической ошибки во время обработки голоса.
OnVoiceProcessingPassEnd	Вызывается сразу после завершения процесса обработки голоса.
OnVoiceProcessingPassStart	Вызывается во время каждого прохода обработки для каждого голоса непосредственно перед тем, как XAudio2 считывает данные из очереди буфера голоса.

Методы

Интерфейс IXAudio2VoiceCallback содержит следующие методы.

IXAudio2VoiceCallback::OnBufferEnd Вызывается, когда голос завершает обработку буфера.
IXAudio2VoiceCallback::OnBufferStart Вызывается, когда голос вот-вот начнет обработку нового звукового буфера.
IXAudio2VoiceCallback::OnLoopEnd Вызывается, когда голос достигает конечной позиции цикла.
IXAudio2VoiceCallback::OnStreamEnd Вызывается, когда голос только что закончил воспроизведение непрерывного аудиопотока.
IXAudio2VoiceCallback::OnVoiceError Вызывается при возникновении критической ошибки во время обработки голоса.
IXAudio2VoiceCallback::OnVoiceProcessingPassEnd Вызывается сразу после завершения процесса обработки голоса.
IXAudio2VoiceCallback::OnVoiceProcessingPassStart Вызывается во время каждого прохода обработки для каждого голоса непосредственно перед тем, как XAudio2 считывает данные из очереди буфера голоса.

Комментарии

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

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

Требования

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

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

Руководство: организация звукового потока с диска

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

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

Интерфейсы XAudio2