In This Topic ▼

IltmfCapture::get_Balance

Summary

Retrieves the balance for the audio stream .

Syntax

#include "ltmf.h"

Language	Syntax
C	HRESULT IltmfCapture_get_Balance(pCapture, pBalance)
C++	HRESULT get_Balance(pBalance)

Parameters

IltmfCapture *pCapture

Pointer to an IltmfCapture interface.

long *pBalance

Pointer to a variable to be updated with the balance value. Possible values range from -10000 to 10000, where -10000 indicates that the right channel is receiving no signal, 10000 indicates that the left channel is receiving no signal, and 0 indicates that both channels are getting 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.

Comments

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.

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.