IBasicAudio::put_Balance
| Microsoft DirectShow 9.0 |
IBasicAudio::put_Balance
The put_Balance method sets the balance of the audio signal.
Syntax
HRESULT put_Balance( long lBalance );
Parameters
lBalance
[in] Specifies the balance. The value can range from -10,000 to 10,000. The value -10,000 means the right channel is attenuated by 100 dB and is effectively silent. The value 10,000 means the left channel is silent. The neutral value is 0, which means that both channels are at full volume. When one channel is attenuated, the other remains at full volume.
Return Values
Returns an HRESULT value. Possible values include the following.
| Value | Description |
| E_FAIL | The underlying audio device returned an error. |
| E_INVALIDARG | The value of lBalance is invalid. |
| E_NOTIMPL | The filter graph does not contain an audio renderer filter. (Possibly the source does not contain an audio stream.) |
| S_OK | Success. |
Requirements
Header: Declared in Control.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also