IltmmCapture::get_InterleaveMode

#include "ltmm.h"

C Syntax

HRESULT IltmmCapture_get_InterleaveMode(pCapture, pVal)

C++ Syntax

HRESULT get_InterleaveMode(pVal)

IltmmCapture *pCapture;

pointer to an interface

long *pVal;

pointer to a variable

Retrieves the current interleaving mode, which is used for writing the target file.

Parameter

Description

pCapture

Pointer to an IltmmCapture interface.

pVal

Pointer to a variable that will receive the current interleaving mode. For a list of possible values, refer to the ltmmCapture_InterleavingMode Constants.

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

Not all file formats support the interleaving mode. For example, AVI file format supports interleaving mode, while WMV file format does not. The interleaving mode is ignored for the formats that do not support it. Interleaving mode tells the multiplexer the method for combining data from various streams (video, audio, etc) in the file. Some interleaving modes will require more processing and more memory, but will generate files more suitable for streaming. Other interleaving modes will be faster, and should be used when speed is necessary (for example, during capture). For more information on these options, refer to ltmmCapture_InterleavingMode Constants.

To change the interleaving mode, call IltmmCapture::put_InterleaveMode.

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::put_InterleaveMode, IltmmCameraControl Interface

Topics:

Multimedia Function Group

Example

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

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

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Multimedia C API Help