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

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