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


Интерфейс 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