IXAudio2SourceVoice::Stop-Methode (xaudio2.h)
Beendet die Audionutzung durch die aktuelle Stimme.
Syntax
HRESULT Stop(
[in] UINT32 Flags,
[in] UINT32 OperationSet
);
Parameter
[in] Flags
Flags, die steuern, wie die Stimme beendet wird. Kann 0 oder folgendes sein:
| Wert | BESCHREIBUNG |
|---|---|
| XAUDIO2_PLAY_TAILS | Setzen Sie die Ausgabe des Effekts fort, nachdem die Stimme beendet wurde. |
[in] OperationSet
Identifiziert diesen Aufruf als Teil eines verzögerten Batches. Weitere Informationen finden Sie in der Übersicht über XAudio2-Vorgangssätze .
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK einen Fehlercode zurück. Beschreibungen von XAudio2-spezifischen Fehlercodes finden Sie unter XAudio2-Fehlercodes.
Hinweise
Alle Quellpuffer, die auf der Stimme und der aktuellen Cursorposition in die Warteschlange eingereiht werden, bleiben erhalten. Dadurch kann die Stimme dort fortfahren, wo sie aufgehört hat, wenn sie neu gestartet wird. Die IXAudio2SourceVoice::FlushSourceBuffers-Methode kann verwendet werden, um Quellpuffer in der Warteschlange zu leeren.
Standardmäßig wird jede ausstehende Ausgabe von Spracheffekten , z. B. Hallschwänze, nicht wiedergegeben. Stattdessen wird die Stimme sofort stumm gerendert. Das XAUDIO2_PLAY_TAILS-Flag kann verwendet werden, um die Ausgabe von Effekten fortzusetzen, nachdem die Sprachausführung beendet wurde.
Eine Stimme, die mit dem XAUDIO2_PLAY_TAILS-Flag beendet wurde, verwendet keine Quellpuffer mehr, verarbeitet aber weiterhin ihre Effekte und sendet Audio an ihre Zielstimme. Eine Stimme in diesem Zustand kann später vollständig beendet werden, indem Stop erneut aufgerufen wird, wobei das Flags-Argument auf 0 festgelegt ist. Dies ermöglicht es, eine Stimme mit XAUDIO2_PLAY_TAILS zu beenden, genügend Zeit zu warten, bis die Audiowiedergabe durch die Effekte beendet wird, und dann die Stimme vollständig zu beenden, indem Sie Wieder beenden ohne XAUDIO2_PLAY_TAILS. Diese Technik ermöglicht es, Stimmen mit Effekten ordnungsgemäß anzuhalten, während sichergestellt wird, dass Stimmen im Leerlauf nicht weiter verarbeitet werden, nachdem sie die Audioproduktion abgeschlossen haben.
Stop ist immer asynchron, auch wenn es innerhalb eines Rückrufs aufgerufen wird.
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 |