ref_vfmethod_copyProc2 - shekh/VirtualDub2 GitHub Wiki

VirtualDub Plugin SDK 1.2

copyProc2 video filter method

copyProc2

Creates a clone of the filter instance.

void copyProc2(VDXFilterActivation *fa, const VDXFilterFunctions *ff, void *dst, VDXFilterActivation *fa2, const VDXFilterFunctions *ff2);

Parameters

fa	Pointer to filter activation structure for current instance.
ff	Pointer to callback function structure for current instance.
dst	Memory location for new instance data.
fa2	Pointer to filter activation structure for new instance.
ff2	Pointer to callback function structure for new instance.

Thread safety

This method is not thread-safe.

Exceptions

Exceptions may be thrown from this function (see Except()).

API version requirement

Requires V14 or later.

Default behavior

If omitted, copyProc is used if available, or else a byte-by-byte memcpy() is done on the instance data.

Remarks

copyProc2 is similar to copyProc, but it includes the activation and function array pointers for the new instance. This fixes an annoyance with the copyProc function where the new activation structure is unknown, so it must be set on all calls that can come next. This is not necessary if copyProc2 is used.

Note that copyProc2 is only available on API V14, so if your filter works on an earlier version, you must still deal with copyProc and its restrictions.