IXAudio2VoiceCallback-Schnittstelle (xaudio2.h)

Artikel
08/28/2023

Die IXAudio2VoiceCallback-Schnittstelle enthält Methoden, die den Client benachrichtigen, wenn bestimmte Ereignisse in einem bestimmten IXAudio2SourceVoice auftreten.

Diese Schnittstelle sollte vom XAudio2-Client implementiert werden. XAudio2 ruft diese Methoden über einen Schnittstellenzeiger auf, der vom Client in der IXAudio2::CreateSourceVoice-Methode bereitgestellt wird. Methoden in dieser Schnittstelle geben void anstelle eines HRESULT zurück.

Einschränkungen für die Rückrufimplementierung finden Sie im Thema XAudio2-Rückrufe .

Methode	BESCHREIBUNG
OnBufferEnd	Wird aufgerufen, wenn die Sprachausgabe die Verarbeitung eines Puffers beendet hat.
OnBufferStart	Wird aufgerufen, wenn die Stimme mit der Verarbeitung eines neuen Audiopuffers beginnt.
OnLoopEnd	Wird aufgerufen, wenn die Stimme die Endposition einer Schleife erreicht.
OnStreamEnd	Wird aufgerufen, wenn die Stimme gerade die Wiedergabe eines zusammenhängenden Audiodatenstroms beendet hat.
OnVoiceError	Wird aufgerufen, wenn während der Sprachverarbeitung ein kritischer Fehler auftritt.
OnVoiceProcessingPassEnd	Wird direkt nach dem Ende des Verarbeitungsdurchlaufs für die Stimme aufgerufen.
OnVoiceProcessingPassStart	Wird während jedes Verarbeitungsdurchlaufs für jede Stimme aufgerufen, kurz bevor XAudio2 Daten aus der Pufferwarteschlange der Stimme liest.

Methoden

Die IXAudio2VoiceCallback-Schnittstelle verfügt über diese Methoden.


IXAudio2VoiceCallback::OnBufferEnd Wird aufgerufen, wenn die Sprachausgabe die Verarbeitung eines Puffers beendet hat.
IXAudio2VoiceCallback::OnBufferStart Wird aufgerufen, wenn die Stimme mit der Verarbeitung eines neuen Audiopuffers beginnt.
IXAudio2VoiceCallback::OnLoopEnd Wird aufgerufen, wenn die Stimme die Endposition einer Schleife erreicht.
IXAudio2VoiceCallback::OnStreamEnd Wird aufgerufen, wenn die Stimme gerade die Wiedergabe eines zusammenhängenden Audiodatenstroms beendet hat.
IXAudio2VoiceCallback::OnVoiceError Wird aufgerufen, wenn während der Sprachverarbeitung ein kritischer Fehler auftritt.
IXAudio2VoiceCallback::OnVoiceProcessingPassEnd Wird direkt nach dem Ende des Verarbeitungsdurchlaufs für die Stimme aufgerufen.
IXAudio2VoiceCallback::OnVoiceProcessingPassStart Wird während jedes Verarbeitungsdurchlaufs für jede Stimme aufgerufen, kurz bevor XAudio2 Daten aus der Pufferwarteschlange der Stimme liest.