IXAudio2::StopEngine-Methode (xaudio2.h)

  • Artikel

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

Weitere Informationen

IXAudio2

XAPO–Übersicht