IAudioEndpointVolume::GetChannelVolumeLevel method (endpointvolume.h)
The GetChannelVolumeLevel method gets the volume level, in decibels, of the specified channel in the audio stream that enters or leaves the audio endpoint device.
Syntax
HRESULT GetChannelVolumeLevel(
[in] UINT nChannel,
[out] float *pfLevelDB
);
Parameters
[in] nChannel
The channel number. If the audio stream has n channels, the channels are numbered from 0 to n– 1. To obtain the number of channels in the stream, call the IAudioEndpointVolume::GetChannelCount method.
[out] pfLevelDB
Pointer to a float variable into which the method writes the volume level in decibels. To get the range of volume levels obtained from this method, call the IAudioEndpointVolume::GetVolumeRange method.
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 |
|---|---|
|
Parameter nChannel is greater than or equal to the number of channels in the stream. |
|
Parameter pfLevelDB is NULL. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2008 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | endpointvolume.h |
See also
IAudioEndpointVolume Interface