ref_iface_IVDXVideoPrefetcher_PrefetchFrame - shekh/VirtualDub2 GitHub Wiki

VirtualDub Plugin SDK 1.2

IVDXVideoPrefetcher interface

IVDXVideoPrefetcher:: PrefetchFrame

Requests prefetch for a source frame.

void PrefetchFrame(sint32 srcIndex, sint64 frame, uint64 cookie);

Parameters

srcIndex	Source stream index to prefetch from. Must be zero.
frame	Frame number to prefetch.
cookie	Arbitrary 64-bit integer value to associate with the frame prefetch.

Thread safety

This method is not thread-safe.

Errors

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

Remarks

This is the main method a video filter uses to tell the host which source frames are needed to produce an output frame. The host waits until all requested frames are available before invoking the runProc() function.

The cookie is an arbitrary value for use by the filter which is not interpreted or modified by the host. It is returned through the mCookie field of the VDXFBitmap structure.