AVIStreamOpenFromFile

The AVIStreamOpenFromFile function opens a single stream from a file.

STDAPI AVIStreamOpenFromFile(
  PAVISTREAM * ppavi,    
  LPCTSTR szFile,        
  DWORD fccType,         
  LONG lParam,           
  UINT mode,             
  CLSID * pclsidHandler  
);
 

Parameters

ppavi
Address to contain the new stream handle.
szFile
Null-terminated string containing the name of the file to open.
fccType
Four-character code indicating the type of stream to be opened. Zero indicates that any stream can be opened. The following definitions apply to the data commonly found in AVI streams:
Value Description
streamtypeAUDIO Indicates an audio stream.
streamtypeMIDI Indicates a MIDI stream.
streamtypeTEXT Indicates a text stream.
streamtypeVIDEO Indicates a video stream.

lParam
Stream of the type specified in fccType to access. This parameter is zero-based; use zero to specify the first occurrence.
mode
Access mode to use when opening the file. This function can open only existing streams, so the OF_CREATE mode flag cannot be used. For more information about the available flags for the mode parameter, see the OpenFile function.
pclsidHandler
Address of a class identifier of the handler you want to use. If the value is NULL, the system chooses one from the registry based on the file extension or the file RIFF type.

Return Values

Returns zero if successful or an error otherwise.

Remarks

This function calls the AVIFileOpen, AVIFileGetStream, and AVIFileRelease functions.

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.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

AVIFile Functions and Macros Overview, AVIFile Functions, OpenFile, AVIFileOpen, AVIFileGetStream, AVIFileRelease