 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. |
A version of this page is also available for
4/8/2010
This method sets the balance of the audio signal.
Syntax
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 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.
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.
Requirements
| 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 |