In This Topic ▼

IltmmCapture::put_InterleaveMode

Summary

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

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmCapture_put_InterleaveMode(pCapture, newVal)
C++	HRESULT put_InterleaveMode(newVal)

Parameters

IltmmCapture *pCapture

Pointer to an IltmmCapture interface.

long newVal

Value that represents the interleaving mode to set. For a list of possible values, refer to the ltmmCapture_InterleavingMode constants.

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 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 get the current interleaving mode, call IltmmCapture::get_InterleaveMode.