ICDrawSuggestFormat

The ICDrawSuggestFormat function notifies the drawing handler to suggest the input data format.

DWORD ICDrawSuggestFormat(
  HIC hic,                    
  LPBITMAPINFOHEADER lpbiIn,  
  LPBITMAPINFOHEADER lpbiOut,  
  int dxSrc,                  
  int dySrc,                  
  int dxDst,                  
  int dyDst,                  
  HIC hicDecompressor         
);
 

Parameters

hic

Handle of the driver to use.

lpbiIn

Address of a structure containing the format of the compressed data. For bitmaps, this is a BITMAPINFOHEADER structure.

lpbiOut

Address of a structure to return the suggested format. The drawing handler can receive and draw data from this format. For bitmaps, this is a BITMAPINFOHEADER structure.

dxSrc, dySrc

Width and height of the source rectangle.

dxDst, dyDst

Width and height of the destination rectangle.

hicDecompressor

Decompressor that can use the format of data in lpbiIn.

Return Values

Returns ICERR_OK if successful or an error otherwise.

Remarks

Applications can use this function to determine alternative input formats that a drawing handler can decompress and if the drawing handler can stretch data. If the drawing handler cannot stretch data as requested, the application might have to stretch the data.

If the drawing handler cannot decompress a format provided by an application, use the ICDecompress, ICDecompressEx, ICDecompressExBegin, ICDecompressExQuery, and ICDecompressOpen functions to obtain alternate formats.

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

Video Compression Manager Overview, Video Compression Functions, BITMAPINFOHEADER, ICDecompress, ICDecompressEx, ICDecompressExBegin, ICDecompressExQuery, ICDecompressOpen