AVIStreamNextKeyFrame

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

AVIStreamNextKeyFrame(
  pavi, 
  lPos  
);
 

Parameters

pavi
Handle of 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) 
 

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.

See Also

AVIFile Functions and Macros Overview, AVIFile Macros