IltmmCapture::put_Volume

#include "ltmm.h"

C Syntax

HRESULT IltmmCapture__put_Volume(pCapture, newVal)

C++ Syntax

HRESULT put_Volume(newVal)

 

IltmmCapture *pCapture;

/* pointer to an interface */

long newVal;

/* volume */

Sets the volume level of the 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 oftware 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. before you can play (hear) it..

Parameter

Description

pCapture

Pointer to an IltmmCapture interface.

newVal

Volume level to set. Possible values range from –10000 to 0.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

Full volume is 0, and –10,000 is silence. The scale is logarithmic. Multiply the desired decibel level by 100 to get the proper value for newVal. For example if you want a volume of –100 dB, set newVal to –100 X 100 or -10000.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Elements:

IltmmCapture::get_Volume

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmCapture::IsPreviewTapSupported Example for C.

For a C++ example, refer to IltmmCapture::IsPreviewTapSupported Example for C++.