IXAudio2Voice::SetVolume-Methode (xaudio2.h)

Artikel
03/04/2024

Legt die Gesamtlautstärke für die Stimme fest.

Syntax

\\HRESULT SetVolume(
  [in] float  Volume,
  [in] UINT32 OperationSet
);

Parameter

[in] Volume

Zu verwendende Gesamtvolumenebene. Weitere Informationen zu Lautstärkeebenen finden Sie unter Hinweise.

[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 Fehlercodes finden Sie unter XAudio2-Fehlercodes .

Hinweise

SetVolume steuert die Lautstärke einer Stimme master. Die master Lautstärke wird je nach Sprachtyp zu unterschiedlichen Zeitpunkten angewendet. Für Submix- und Masterstimme wird die Lautstärke direkt vor dem Anwenden des integrierten Filters und der Effektkette der Stimme angewendet. Für Quellstimme wird der master Lautstärkepegel angewendet, nachdem der Filter und die Effektkette der Stimme angewendet wurden.

Volumenpegel werden als Gleitkommaamplitsmultiplikatoren zwischen -XAUDIO2_MAX_VOLUME_LEVEL und XAUDIO2_MAX_VOLUME_LEVEL (-2²⁴ bis 2²⁴) mit einer maximalen Verstärkung von 144,5 dB ausgedrückt. Ein Lautstärkepegel von 1,0 bedeutet, dass es keine Dämpfung oder Verstärkung gibt und 0 bedeutet Stille. Negative Werte können verwendet werden, um die Audiophase umzukehren. Weitere Informationen zur Lautstärkeregelung finden Sie unter XAudio2-Lautstärke- und Tonhöhensteuerung .

HinweisIXAudio2Voice::GetVolume gibt immer das volume zurück, das zuletzt von IXAudio2Voice::SetVolume festgelegt wurde. Es ist jedoch möglicherweise noch nicht tatsächlich in Kraft: Es wird nur wirksam, wenn die Audio-Engine nach dem IXAudio2Voice::SetVolume-Aufruf (oder nach dem entsprechenden IXAudio2::CommitChanges-Aufruf , wenn IXAudio2Voice::SetVolume mit einer verzögerten Vorgangs-ID aufgerufen wurde).

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

Vorgehensweise: Ändern der Sprachlautstärke

So wird's gemacht: Verwenden von Submixstimmen

IXAudio2Voice

Freigeben über