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