Share via


AVIStreamNextKeyFrameTime

The AVIStreamNextKeyFrameTime macro returns the time of the next key frame in the stream, starting at a given time.

AVIStreamNextKeyFrameTime(
  pavi, 
  time  
);

Parameters

pavi

Handle to an open stream.

time

Position in the stream to begin searching.

Return Values

Returns the time if successful or  - 1 otherwise.

Remarks

The search performed by this macro includes the frame that corresponds to the specified time.

The AVIStreamNextKeyFrameTime macro is defined as follows:

#define AVIStreamNextKeyFrameTime(pavi, time) \ 
    AVIStreamSampleToTime(pavi, \ 
    AVIStreamNextKeyFrame(pavi, \ 
    AVIStreamTimeToSample(pavi, time))) 

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.

See Also

AVIFile Functions and Macros, AVIFile Macros