IXAudio2SourceVoice::Stop-Methode (xaudio2.h)

Artikel
08/28/2023

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.

Hinweis XAudio2 ruft niemals Sprachrückrufe für eine Stimme auf, wenn die Stimme beendet wird (auch wenn sie mit XAUDIO2_PLAY_TAILS beendet wurde).

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

IXAudio2SourceVoice

Übersicht über XAPO

Share via