IBasicAudio::get_Balance
| Microsoft DirectShow 9.0 |
IBasicAudio::get_Balance
The get_Balance method retrieves the balance for the audio signal.
Syntax
HRESULT get_Balance( long *plBalance );
Parameters
plBalance
[out] Pointer to a variable that receives the balance.
Return Values
Returns an HRESULT value. Possible values include the following.
| Value | Description |
| E_NOTIMPL | The filter graph does not contain an audio renderer filter. (Possibly the source does not contain an audio stream.) |
| E_POINTER | Null pointer argument. |
| S_OK | Success. |
Remarks
The balance ranges 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.
Requirements
Header: Declared in Control.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also