IXAudio2SourceVoice::D iscontinuity-Methode (xaudio2.h)

Benachrichtigt eine XAudio2-Stimme, dass nach dem letzten, der sich derzeit in der Warteschlange befindet, keine Puffer mehr eingereiht werden.

Syntax

HRESULT Discontinuity();

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK einen Fehlercode zurück.

Hinweise

Die Diskontinuität unterdrückt die Warnungen, die normalerweise im Debugbuild von XAudio2 auftreten, wenn für eine Stimme keine Audiopuffer mehr zur Wiedergabe vorhanden sind. Es ist besser, den endgültigen Puffer eines Datenstroms zu markieren, indem er mit dem flag XAUDIO2_END_OF_STREAM markiert wird. In einigen Fällen weiß der Client jedoch möglicherweise erst, nachdem der Puffer übermittelt wurde, dass ein Puffer das Ende eines Datenstroms ist.

Da das Aufrufen von Diskontinuität dem rückwirkenden Anwenden des XAUDIO2_END_OF_STREAM-Flags auf den zuletzt übermittelten Puffer entspricht, wird nach Abschluss dieses Puffers ein OnStreamEnd-Rückruf durchgeführt.

Hinweis XAudio2 kann die gesamte Pufferwarteschlange nutzen und eine Warnung ausgeben, bevor der Diskontinuitätsaufruf wirksam wird, sodass die Diskontinuität nicht garantiert ist, um die Warnungen zu unterdrücken.

 

Plattformanforderungen

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	xaudio2.h

Weitere Informationen

IXAudio2SourceVoice