estrutura XAUDIO2FX_VOLUMEMETER_LEVELS (xaudio2fx.h)

Artigo
08/28/2023

Descreve os parâmetros para uso com o APO do medidor de volume.

Sintaxe

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

Membros

pPeakLevels

Matriz que será preenchida com o nível absoluto máximo para cada canal durante uma passagem de processamento. A matriz deve ser, pelo menos , ChannelCount × bytes sizeof(float). pPeakLevels poderá ser NULL se pRMSLevels não for NULL.

pRMSLevels

Matriz que será preenchida com o nível quadrado médio raiz para cada canal durante uma passagem de processamento. A matriz deve ser, pelo menos , ChannelCount × bytes sizeof(float). pRMSLevels poderá ser NULL se pPeakLevels não for NULL.

ChannelCount

Número de canais sendo processados.

Comentários

Essa estrutura é usada com o método XAudio2 IXAudio2Voice::GetEffectParameters .

pPeakLevels e pRMSLevels não são retornados por IXAudio2Voice::GetEffectParameters, as matrizes só serão preenchidas se estiverem presentes. Se pPeakLevels e pRMSLevels forem usados , eles deverão ser alocados pelo aplicativo. O aplicativo é responsável por liberar as matrizes quando elas não são mais necessárias.

ChannelCount deve ser definido pelo aplicativo para corresponder ao número de canais na voz à qual o efeito é aplicado.