IPerChannelDbLevel::GetLevel method

The GetLevel method gets the volume level, in decibels, of the specified channel.

Syntax


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

Parameters

nChannel [in]

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 IPerChannelDbLevel::GetChannelCount method.

pfLevelDB [out]

Pointer to a float variable into which the method writes the volume level, in decibels, of the specified channel.

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 codeDescription
E_INVALIDARG

Parameter nChannel is out of range.

E_POINTER

Pointer pfLevelDB is NULL.

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Devicetopology.h

See also

IPerChannelDbLevel Interface
IPerChannelDbLevel::GetChannelCount

 

 

Show: