XAUDIO2FX_VOLUMEMETER_LEVELS-Struktur (xaudio2fx.h)

Artikel
08/28/2023

Beschreibt Parameter für die Verwendung mit dem Volumemeter APO.

Syntax

typedef struct XAUDIO2FX_VOLUMEMETER_LEVELS {
  float  *pPeakLevels;
  float  *pRMSLevels;
  UINT32 ChannelCount;
} XAUDIO2FX_VOLUMEMETER_LEVELS;

Member

pPeakLevels

Array, das während eines Verarbeitungsdurchlaufs mit der maximalen absoluten Ebene für jeden Kanal gefüllt wird. Das Array muss mindestens ChannelCount × sizeof(float)bytes sein. pPeakLevels kann NULL sein, wenn pRMSLevels nicht NULL ist.

pRMSLevels

Array, das während eines Verarbeitungsdurchlaufs mit der mittleren Quadratebene für jeden Kanal gefüllt wird. Das Array muss mindestens ChannelCount × sizeof(float)bytes sein. pRMSLevels kann NULL sein, wenn pPeakLevels nicht NULL ist.

ChannelCount

Anzahl der verarbeiteten Kanäle.

Hinweise

Diese Struktur wird mit der XAudio2 IXAudio2Voice::GetEffectParameters-Methode verwendet.

pPeakLevels und pRMSLevels werden von IXAudio2Voice::GetEffectParameters nicht zurückgegeben. Die Arrays werden nur ausgefüllt, wenn sie vorhanden sind. Wenn pPeakLevels und pRMSLevels verwendet werden, müssen sie von der Anwendung zugeordnet werden. Die Anwendung ist für die Freigabe der Arrays verantwortlich, wenn sie nicht mehr benötigt werden.

ChannelCount muss von der Anwendung so festgelegt werden, dass die Anzahl der Kanäle in der Stimme, auf die der Effekt angewendet wird, übereinstimmt.