ITBasicAudioTerminal::put_Balance method (tapi3if.h)

Article
10/13/2021

The put_Balance method sets the balance. This method is not implemented for terminals shipped with TAPI 3.0 and higher.

Syntax

HRESULT put_Balance(
  [in] long lBalance
);

Parameters

[in] lBalance

Balance.

Return value

This method can return one of these values.

Return code	Description
S_OK	Method succeeded.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.
E_NOTIMPL	Terminal's balance methods are not implemented.

Remarks

The balance property is a value between –10,000 and 10,000. A value of –10,000 indicates that the right speaker has been disabled and only the left speaker is receiving an audio signal. A value of 0 indicates that both speakers are receiving equivalent audio signals. A value of 10,000 indicates that the left speaker has been disabled and only the right speaker is receiving an audio signal.

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h (include Tapi3.h)
Library	Uuid.lib
DLL	Tapi3.dll