AVIStreamNearestKeyFrameTime

The AVIStreamNearestKeyFrameTime macro determines the time corresponding to the beginning of the key frame nearest (at or preceding) a specified time in a stream.

AVIStreamNearestKeyFrameTime(
  pavi,  
 lTime  
);

Parameters

pavi

Handle to an open stream.

lTime

Starting time, in milliseconds, to search in the stream.

Return Values

Returns the time of the nearest key frame if successful or  - 1 otherwise.

Remarks

The AVIStreamNearestKeyFrameTime macro is defined as follows:

#define AVIStreamNearestKeyFrameTime(pavi, lTime) \ 
    AVIStreamSampleToTime(pavi, AVIStreamNearestKeyFrame(pavi, 
    AVIStreamTimeToSample(pavi, lTime))) 

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