ref_iface_IVDXVideoSource_GetRealFrame - shekh/VirtualDub2 GitHub Wiki

VirtualDub Plugin SDK 1.2

IVDXVideoSource interface

IVDXVideoSource:: GetRealFrame

Returns the actual frame being decoded for a given frame in the source.

sint64 GetRealFrame(sint64 frame_num);

Parameters

frame_num	Number of frame being queried.

Thread safety

This method is not thread-safe.

Errors

Errors may not be returned from this function (see SetError()).

Return value

The frame number of the actual frame that is decoded.

Remarks

This routine is used to determine when multiple frame entries in the video source are being supported by a single actual frame, such as due to covering a dropout or due to frame duplication. It is used in Direct Stream Copy mode to determine when a frame can be omitted. GetRealFrame(frame_num) != frame_num implies that a particular frame is supported by a dummy sample which can be omitted during copying. For instance, if GetRealFrame() returns 2 for frames 2-5, the underlying samples for frames 3-5 can be replaced with null frames or deleted without disturbing decoding.