AVIStreamNextSample

The AVIStreamNextSample macro locates the next nonempty sample from a specified position in a stream.

AVIStreamNextSample(
  pavi, 
  lPos  
);

Parameters

pavi

Handle to an open stream.

lPos

Starting position to search in the stream.

Return Values

Returns the sample position if successful or  - 1 otherwise.

Remarks

The sample position returned does not include the sample specified by lPos.

The AVIStreamNextSample macro is defined as follows:

#define AVIStreamNextSample(pavi, lPos) \ 
    AVIStreamFindSample(pavi, lPos + 1, FIND_NEXT | FIND_ANY) 

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