Platform SDK: TAPI

ITBasicAudioTerminal::get_Balance

Gets the balance. This method is not implemented for terminals shipped with TAPI 3.0.

HRESULT get_Balance(
  long *plBalance
);

Parameters

plBalance
[out, retval] Pointer to balance.

Return Values

Value Meaning
S_OK Method succeeded.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.
TAPI_E_NOTSUPPORTED Terminal does not support balance operations.
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

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITBasicAudioTerminal, put_Balance, Terminal Object