IltmfCapture::put_Balance

Summary

Sets the balance value for the audio stream .

Syntax

#include "ltmf.h"

Language Syntax
C HRESULT IltmfCapture_put_Balance(pCapture, Balance)
C++ HRESULT put_Balance(Balance)

Parameters

IltmfCapture *pCapture

Pointer to an IltmfCapture interface.

long Balance

The balance value to set. Possible values range from -10000 to 10000, where -10000 indicates that the right channel will receive no signal, 10000 indicates that the left channel will receive no signal, and 0 indicates that both channels will get the same amount of the audio signal.

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

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

Audio stream

The portion of the file holding the audio data. The audio data might be compressed to save disk space. The data has to be decompressed using an audio decompressor before you can play (hear) it.

Audio decompressor

Software component which decompresses audio. It must be designed to work with ACM or DirectShow. Note that different compression methods require different decompressors. There is no universal decompressor capable of decoding all compressed streams.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

For a C++ example, refer to Using Mute with ltmfCapture Example 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.