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.
A version of this page is also available for

This method sets the balance of the audio signal.


HRESULT put_Balance(



[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 are given the same amplitude audio signal.

Return Value

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.


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.


Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment,
Version 2.12 requires DXPAK 1.0 or later