AVIStreamGetFrameOpen

  • Article

The AVIStreamGetFrameOpen function prepares to decompress video frames from the specified video stream.

STDAPI_(PGETFRAME) AVIStreamGetFrameOpen(
  PAVISTREAM pavi,               
  LPBITMAPINFOHEADER lpbiWanted  
);

Parameters

pavi

Pointer to the video stream used as the video source.

lpbiWanted

Pointer to a structure that defines the desired video format. Specify NULL to use a default format. You can also specify AVIGETFRAMEF_BESTDISPLAYFMT to decode the frames to the best format for your display.

Return Values

Returns a GetFrame object that can be used with the AVIStreamGetFrame function. If the system cannot find a decompressor that can decompress the stream to the given format, or to any RGB format, the function returns NULL.

The argument pavi is a pointer to an IAVIStream interface.

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

AVIFile Functions and Macros, AVIFile Functions, AVIStreamGetFrame