Share via


AVIStreamNextKeyFrame

The AVIStreamNextKeyFrame macro locates the next key frame following a specified position in a stream.

AVIStreamNextKeyFrame(
  pavi, 
 lPos  
);

Parameters

pavi

Handle to an open stream.

lPos

Starting position to search in the stream.

Return Values

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

Remarks

The search performed by this macro does not include the frame at the specified position.

The AVIStreamNextKeyFrame macro is defined as follows:

#define AVIStreamNextKeyFrame(pavi, lPos) \ 
    AVIStreamFindSample(pavi, lPos + 1, FIND_NEXT | FIND_KEY) 

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