Microsoft DirectX 9.0


The put_Balance method sets the balance of the audio signal.


HRESULT put_Balance(
  long 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.

See Also