# 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 to 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)))
```

Requirements

Windows NT/2000/XP: Included in Windows NT 3.1 and later.
Windows 95/98/Me: Included in Windows 95 and later.