AVIStreamSampleSize

The AVIStreamRelease macro determines the size of the buffer needed to store one sample of information from a stream. The size corresponds to the sample at the position specified by lPos.

AVIStreamSampleSize(
  pavi,  
  lPos,  
  plSize 
);

Parameters

pavi

Handle to an open stream.

lPos

Position of a sample in the stream.

plSize

Address to contain the buffer size.

Return Values

Returns zero if successful or an error otherwise. Possible error values include the following:

AVIERR_BUFFERTOOSMALL The buffer size was smaller than a single sample of data.
AVIERR_MEMORY There was not enough memory to complete the read operation.
AVIERR_FILEREAD A disk error occurred while reading the file.

Remarks

The AVIStreamSampleSize macro is defined as follows:

#define AVIStreamSampleSize(pavi, lPos, plSize) \ 
    AVIStreamRead(pavi, lPos, 1, NULL, 0, plSize, NULL) 

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