IltmfPlay::get_Balance

Summary

Retrieves the balance for the audio signal.

Syntax

#include "ltmf.h"

Language Syntax
C HRESULT IltmfPlay_get_Balance(pPlay, pVal)
C++ HRESULT get_Balance(pVal)

Parameters

IltmfPlay *pPlay

Pointer to an IltmfPlay interface.

long *pVal

Pointer to a variable receives the balance value.

Returns

Value Meaning
S_OK The function was successful.
<> S_OK An error occurred. Refer to the Error Codes or the HRESULT error codes in the MediaFoundation documentation.

Comments

The balance 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.

Units correspond to .01 decibels (multiplied by 1 when pVal 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

Platforms

Win32, x64.

See Also

Functions

Topics

Example

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

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Media Foundation C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.