IAVIFile::GetStream

The GetStream method opens a stream by accessing it in a file. Called when an application uses the AVIFileGetStream function.

HRESULT GetStream(
  PAVIFILE pf,           
  PAVISTREAM *ppStream,  
  DWORD fccType,         
  LONG lParam            
);
 

Parameters

pf

Address of the interface to a file.

ppStream

Address to contain a pointer to the interface to a stream.

fccType

Four-character code indicating the type of stream to locate.

lParam

Stream number.

Return Values

Returns the HRESULT defined by OLE.

Remarks

It is typically easier to implement this method by creating all of the stream objects in advance by using the IAVIFile::Open method. Then, this method accesses the interface to the specified stream.

Remember to increment the reference count maintained by the AddRef method for the stream when this method is used.

For handlers written in C++, GetStream has the following syntax:

HRESULT GetStream(PAVISTREAM *ppStream, 
    DWORD fccType, LONG lParam); 
 

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

Custom File and Stream Handlers Overview, Custom File and Stream Handler Interfaces, AVIFileGetStream, IAVIFile::Open