IAVIFile::GetStream

  • Article

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

Pointer to the interface to a file.

ppStream

Pointer to a buffer that receives 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);

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.
**  Library:** Use Vfw32.lib.

See Also

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