IAudioPeakMeter::GetLevel method (devicetopology.h)

The GetLevel method gets the peak level that the peak meter recorded for the specified channel since the peak level for that channel was previously read.

Syntax

HRESULT GetLevel(
  [in]  UINT  nChannel,
  [out] float *pfLevel
);

Parameters

[in] nChannel

The channel number. If the audio stream has N channels, the channels are numbered from 0 to N– 1. To get the number of channels in the stream, call the IAudioPeakMeter::GetChannelCount method.

[out] pfLevel

Pointer to a float variable into which the method writes the peak meter level in decibels.

Return value

If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.

Return code Description
E_INVALIDARG
Parameter nChannel is out of range.
E_POINTER
Pointer pfLevel is NULL.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header devicetopology.h

See also

IAudioPeakMeter Interface

IAudioPeakMeter::GetChannelCount