SelectBitmap

BOOL SelectBitmap(
  LPPDEVICE lpDevice, 
  LPBITMAP lpPrevBitmap, 
  LPBITMAP lpBitmap, 
  DWORD fFlags
 );
 

Selects a bitmap into the specified device, replacing the previous bitmap.

• Returns 1 if successful, zero otherwise.

lpDevice

Address of a PDEVICE structure that specifies the device for which the bitmap is to be selected.

lpPrevBitmap

Address of a PBITMAP structure that specifies the previously selected device bitmap.

lpBitmap

Address of a PBITMAP structure that specifies the device bitmap to select.

fFlags

Actions to take while selecting the bitmap. Support for this parameter is not currently implemented; the parameter must be zero.

The export ordinal for this function is 29.

If the driver supports device bitmaps, GDI calls this function when an application calls the SelectObject function (GDI.45) to select a bitmap.

A graphics device driver must export the SelectBitmap function if the RC_DEVBITS value is set in the dpRaster member of the driver's GDIINFO structure.

The lpPrevBitmap and lpBitmap parameters may point to either main memory or device bitmaps. The SelectBitmap function must determine the bitmap type and carry out any device-specific operations to select or cancel the selected device bitmaps.

See Also

PDEVICE, PBITMAP, GDIINFO