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 AutoLive tolerance used to play 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

Functions:	ILMNetDmx::get_AutoLiveTolerance
Topics:	Streaming Function Groups, Multimedia Function Group, DVD Function Groups