ref_iface_IVDXVideoDecoderModel_GetNextRequiredSample

VirtualDub Plugin SDK 1.2

IVDXVideoDecoderModel interface

IVDXVideoDecoderModel:: GetNextRequiredSample

Returns the next source sample required to decode the current target frame, or -1 if no more samples are required.

sint64 GetNextRequiredSample(bool& is_preroll);

Parameters

is_preroll

[Out] Set to true if the sample is only required for internal decoding, or false if the sample is decoded to the final frame.

Thread safety

This method is not thread-safe.

Errors

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

Remarks

SetDesiredFrame() must be called before GetNextRequiredSample(). If this method immediately returns -1 after the target frame is set, it means that the frame is already resident in an internal decoder buffer, in which case the client must call IVDXVideoDecoder::DecodeFrame() with a zero-byte frame to decode the frame.

---

Copyright (C) 2007-2012 Avery Lee.