IltmmPlay::put_Balance

#include "ltmm.h"

C Syntax

HRESULT IltmmPlay_put_Balance(pPlay, newVal)

C++ Syntax

HRESULT put_Balance(newVal)

 

IltmmPlay *pPlay;

/* pointer to an interface */

long newVal;

/* balance value */

Sets the balance of the audio signal.

Parameter

Description

pPlay

Pointer to an IltmmPlay interface.

newVal

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.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

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

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Elements:

IltmmPlay::get_Balance, IltmmPlay::put_Volume, IltmmPlay::put_Mute

Topics:

Multimedia Function Group

Example

For a C example, refer to the Simple Media Player for C.

For a C++ example, refer to the Simple Media Player for C++.