DrawDibProfileDisplay

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

BOOL DrawDibProfileDisplay(
  LPBITMAPINFOHEADER lpbi  
);

Parameters

lpbi

Pointer to 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.

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

DrawDib, DrawDib Functions, BITMAPINFOHEADER, StretchDIBits

Show: