DrawDibProfileDisplay

The DrawDibProfileDisplay function determines settings for the display system when using DrawDib functions.

BOOL DrawDibProfileDisplay(
  LPBITMAPINFOHEADER lpbi  
);
 

Parameters

lpbi
Address of a BITMAPINFOHEADER structure that contains bitmap information. You can also specify NULL to verify that the profile information is current. If the profile information is not current, DrawDib will rerun the profile tests to obtain a current set of information. When you call DrawDibProfileDisplay with this parameter set to NULL, the return value is meaningless.

Return Values

Returns a value that indicates the fastest drawing and stretching capabilities of the display system. This value can be zero if the bitmap format is not supported or one or more of the following values:

Value Description
PD_CAN_DRAW_DIB DrawDib can draw images using this format. Stretching might or might not also be supported.
PD_CAN_STRETCHDIB DrawDib can stretch and draw images using this format.
PD_STRETCHDIB_1_1_OK StretchDIBits draws unstretched images using this format faster than an alternative method.
PD_STRETCHDIB_1_2_OK StretchDIBits draws stretched images (in a 1:2 ratio) using this format faster than an alternative method.
PD_STRETCHDIB_1_N_OK StretchDIBits draws stretched images (in a 1:N ratio) using this format faster than an alternative method.

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

DrawDib Overview, DrawDib Functions, BITMAPINFOHEADER, StretchDIBits