IXAudio2Voice::GetChannelVolumes-Methode (xaudio2.h)

Artikel
03/04/2024

Gibt die Lautstärkestufen für die Stimme pro Kanal zurück.

Syntax

\\ void GetChannelVolumes(
  [in]  UINT32 Channels,
  [out] float  *pVolumes
);

Parameter

[in] Channels

Bestätigt die Kanalanzahl der Stimme.

[out] pVolumes

Gibt den aktuellen Lautstärkepegel jedes Kanals in der Stimme zurück. Das Array muss mindestens Über Channels-Elemente verfügen. Weitere Informationen zu Lautstärkepegeln finden Sie unter Hinweise.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Diese Einstellungen werden angewendet, nachdem die Effektkette angewendet wurde. Diese Methode ist nur für Quell- und Submixstimmstimden gültig, da mastering voices keine Lautstärke pro Kanal angeben.

Volumenpegel werden als Gleitkommaamplitamplitermultiplikatoren zwischen -2²⁴ und 2²⁴ mit einem maximalen Verstärkung von 144,5 dB ausgedrückt. Ein Volumen von 1 bedeutet, dass es keine Dämpfung oder Verstärkung gibt, 0 bedeutet Stille und negative Pegel können verwendet werden, um die Audiophase umzukehren. Weitere Informationen zur Lautstärkeregelung finden Sie unter XAudio2 Volume and Pitch Control .

HinweisGetChannelVolumes gibt immer die zuletzt von IXAudio2Voice::SetChannelVolumes festgelegten Volumeebenen zurück. Diese Werte sind jedoch möglicherweise noch nicht wirksam: Sie werden erst bei der nächsten Ausführung der Audio-Engine nach dem IXAudio2Voice::SetChannelVolumes-Aufruf (oder nach dem entsprechenden IXAudio2::CommitChanges-Aufruf wirksam, 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

IXAudio2Voice

Freigeben über