Microsoft DirectX 8.1 (C++)

IBasicAudio::put_Balance

The put_Balance method sets the balance of the audio signal.

Syntax

HRESULT put_Balance(
  long lBalance
);

Parameters

lBalance

[in] Value to which to set the balance. The allowable input range is –10,000 to 10,000. A value of 0 sets a neutral balance—both left and right speakers will be given the same amplitude audio signal.

Return Values

Returns an HRESULT value. E_INVALIDARG is returned for values outside the allowable input range and E_FAIL is returned if the underlying device returns an error.

Remarks

Units correspond to .01 decibels (multiplied by –1 when lBalance is a positive value). For example, a value of 1000 indicates –10 dB on the right channel and –90 dB on the left channel.

See Also