IBasicAudio::put_Balance

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 Balance property.

    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 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

As with the Volume property, 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.

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