IXAudio2Voice::SetChannelVolumes-Methode (xaudio2.h)

Artikel
03/04/2024

Legt die Lautstärken für die Stimme pro Kanal fest.

Syntax

\\HRESULT SetChannelVolumes(
  [in] UINT32      Channels,
  [in] const float *pVolumes,
  [in] UINT32      OperationSet
);

Parameter

[in] Channels

Anzahl der Kanäle in der Stimme.

[in] pVolumes

Array, das die neuen Volumes jedes Kanals in der Stimme enthält. Das Array muss Über Channels-Elemente verfügen. 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 XAudio2-spezifischen Fehlercodes finden Sie unter XAudio2-Fehlercodes.

Hinweise

SetChannelVolumes steuert die Ausgabepegel einer Stimme pro Kanal und wird direkt nach dem endgültigen SRC der Stimme und vor deren Sendevorgängen angewendet.

Diese Methode ist nur für Quell- und Submixstimmstimden gültig, da mastering voices keine Lautstärke pro Kanal angeben.

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 Volumen von 1 bedeutet, dass es keine Dämpfung oder Keinen Gewinn 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::GetChannelVolumes gibt immer die Lautstärkeebenen zurück, die zuletzt von IXAudio2Voice::SetChannelVolumes festgelegt wurden. Diese Werte sind jedoch möglicherweise noch nicht wirksam: Sie werden erst wirksam, wenn die Audio-Engine das nächste Mal nach dem IXAudio2Voice::SetChannelVolumes-Aufruf ausgeführt wird (oder nach dem entsprechenden IXAudio2::CommitChanges-Aufruf , wenn IXAudio2Voice::SetChannelVolumes 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

IXAudio2Voice

Freigeben über