AVIFileReadData

The AVIFileReadData function reads optional header data that applies to the entire file, such as author or copyright information.

STDAPI AVIFileReadData(
  PAVIFILE pfile, 
  DWORD ckid,     
  LPVOID lpData,  
  LONG * lpcbData 
);
 

Parameters

pfile

Handle of an open AVI file.

ckid

RIFF chunk identifier (four-character code) of the data.

lpData

Address of the buffer used to return the data read.

lpcbData

Address of a location indicating the size of the memory block referenced by lpData. If the data is read successfully, the value is changed to indicate the amount of data read.

Return Values

Returns zero if successful or an error otherwise. The return value AVIERR_NODATA indicates that data with the requested chunk identifier does not exist.

Remarks

The optional header information is custom and does not have a set format.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.
  Import Library: Use vfw32.lib.

See Also

AVIFile Functions and Macros Overview, AVIFile Functions