Интерфейс 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 |
См. также раздел
Руководство: организация звукового потока с диска
Руководство: использование обратных вызовов речевых источников