IltmmCapture::put_UseVideoDeviceAudio

#include "ltmm.h"

C Syntax

HRESULT IltmmCapture_put_ UseVideoDeviceAudio(pCapture, newVal)

C++ Syntax

HRESULT put_UseVideoDeviceAudio(newVal)

 

IltmmCapture * pCapture;

/* pointer to an interface */

VARIANT_BOOL newVal;

/* property value*/

Specifies whether or not the ltmmCapture object uses the audio from the video device.

Parameter

Description

PCapture

Pointer to an IltmmCapture interface.

newVal

Value that specifies whether or not the lttmCapture uses the audio in the video device. Possible values are:

 

Value

Meaning

 

VARIANT_FALSE

The audio in the video device is not used.

 

VARIANT_TRUE

The audio in the video device is used.

Returns

S_OK

The function ran successfully.

<> S_OK

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

Comments

Call IltmmCapture::get_UseVideoDeviceAudio to retrieve whether or not the audio from the video device is used.

The default value for this property is VARIANT_TRUE. It specifies whether the ltmmCapture object will use the audio from the video device, if no audio devices have been selected. For instance, DV DV stands for Digital Video and has been defined in "Specification of Consumer-use Digital VCRs" (aka the Blue Book). devices contain both audio and video. Normally, if you select a DV device with no audio device, the toolkit will use the DV device's 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.. However, if you set this property to VARIANT_FALSE, then no audio stream will be rendered. This helps build a slightly more efficient graph when processing video only from DV devices.

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.

Platforms

Win32, x64

See Also

Elements:

IltmmCapture interface, IltmmCapture::get_UseVideoDeviceAudio

Topics:

Multimedia Function Group

Example

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

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