IAudioStreamVolume::SetChannelVolume method (audioclient.h)
The SetChannelVolume method sets the volume level for the specified channel in the audio stream.
Syntax
HRESULT SetChannelVolume(
[in] UINT32 dwIndex,
[in] const float fLevel
);
Parameters
[in] dwIndex
The channel number. If the stream format has N channels, the channels are numbered from 0 to N– 1. To get the number of channels, call the IAudioStreamVolume::GetChannelCount method.
[in] fLevel
The volume level for the channel. Valid volume levels are in the range 0.0 to 1.0.
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 dwIndex is set to an invalid channel number, or parameter fLevel is not in the range 0.0 to 1.0. |
|
The audio endpoint device has been unplugged, or the audio hardware or associated hardware resources have been reconfigured, disabled, removed, or otherwise made unavailable for use. |
|
The Windows audio service is not running. |
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Target Platform | Windows |
Header | audioclient.h |