ILMNetDmx::put_AutoLiveTolerance

#include "ILMNetDmx2.h"

C Syntax

HRESULT ILMNetDmx__put_AutoLiveTolerance(pNetDmx, AutoLiveTolerance)

C++ Syntax

HRESULT put_AutoLiveTolerance(AutoLiveTolerance)

 

ILMNetDmx * pNetDmx;

/* pointer to an interface */

double AutoLiveTolerance;

/* AutoLiveTolerance value in seconds */

Sets the name of the file to be used for recording the incoming stream.

Parameter

Description

pNetDmx

Pointer to an ILMNetDmx interface.

AutoLiveTolerance

Set to 0 (default) to indicate that the demux should always try to display live video stream. This will cause video playback to be jerky on jittery networks.

Set to > 0 to instruct the demux to favor smooth playback over live video. In this case, the video might fall a little behind if network packets arrive late.

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

Right now, all values > 0 for AutoLiveTolerance instruct the network demux to prefer smooth video over live video. Future versions of the demultiplexer will use this value to fine-tune the video playback latency.

The default is 0, which will force the network demux to favor live video. This can cause jerky playback on jittery networks with high latencies. VPNs and wireless networks are examples of jittery networks.

These jittery networks have occasional bottlenecks, which cause some packets to arrive with significant delays (could be several seconds). For these networks, the default behavior of choosing live video will cause the playback to freeze and then speed up when the interruptions occur, causing multiple packets to arrive at the same time. If this effect becomes undesirable, you can set the AutoLiveTolerance to a value greater than 0 (for example, set it to 3) to allow the demux to smooth the playback. You should keep in mind, however, that once you favor smooth playback, the playback stream will start to drift behind the live stream. So there might be a delay of several seconds between what you see and what is captured at the other end.

Required DLLs and Libraries

LMNetDmx
DSKernel

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

Functions:

ILMNetDmx::get_AutoLiveTolerance

Topics:

Video Streaming Function Groups, Multimedia Function Group, DVD Function Groups