Microsoft Windows CE 3.0  

IBasicAudio::put_Balance

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Sets the balance of the audio signal.

HRESULT put_Balance(
long
lBalance
);

Parameters

lBalance
[in] Value to which to set the Balanceproperty. 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 HRESULTvalue. E_INVALIDARG is returned for values outside the allowable input range and E_FAIL is returned if the underlying device returns an error.

Remarks

As with the Volumeproperty, units correspond to .01 decibels (multiplied by –1 when lBalanceis a positive value). For example, a value of 1000 indicates –10 dB on the right channel and –90 dB on the left channel.