Edit

IAudioPeakMeter::GetLevel method (devicetopology.h)

  • Article

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