AVIStreamNearestSampleTime

The AVIStreamNearestSampleTime macro determines the time corresponding to the beginning of a sample that is nearest to a specified time in a stream.

AVIStreamNearestSampleTime(
  pavi,  
  lTime  
);
 

Parameters

pavi

Handle of an open stream.

lTime

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

Return Values

Returns the time of the nearest sample if successful or – 1 otherwise.

Remarks

The AVIStreamNearestSampleTime macro is defined as follows:

#define AVIStreamNearestSampleTime(pavi, lTime) \ 
    AVIStreamSampleToTime(pavi, AVIStreamNearestSample(pavi, 
    AVIStreamTimeToSample(pavi, lTime))) 
 

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