IXAudio2::StopEngine-Methode (xaudio2.h)
Beendet den Audioverarbeitungsthread.
Syntax
void StopEngine();
Rückgabewert
Keine
Bemerkungen
Wenn StopEngine aufgerufen wird, wird die gesamte Ausgabe sofort beendet. Das Audiodiagramm bleibt jedoch unberührt, sodass Effektparameter, Effektverläufe (z. B. die von einem Halleffekt gespeicherten Daten, um Echos eines vorherigen Sounds auszustrahlen), Sprachzustände, ausstehende Quellpuffer, Cursorpositionen usw. beibehalten werden. Wenn das Modul neu gestartet wird, ist die resultierende Audioausgabe – abgesehen von einer Stille – identisch mit der Ausgabe, die erzeugt worden wäre, wenn das Modul nie angehalten worden wäre.
Es ist ungültig, StopEngine innerhalb eines Rückrufs (also IXAudio2EngineCallback oder IXAudio2VoiceCallback) aufzurufen.
Plattformanforderungen
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | xaudio2.h |