BitmapBits

BOOL BitmapBits(
  LPPDEVICE lpDevice, 
  DWORD fFlags, 
  DWORD dwCount, 
  LPSTR lpBits
 );

Sets, retrieves, or copies bitmap data.

• Returns the number of bits copied.

lpDevice

Address of a PDEVICE or PBITMAP structure that specifies a device or memory bitmap.

fFlags

Flag that specifies whether to set, retrieve, or copy bitmap data. Can be one of these values:

DBB_SET (1)	Sets bitmap bits by copying data from the buffer pointed to by the lpBits parameter to the specified device.
DBB_GET (2)	Retrieves bitmap bits by copying data from the specified device to the buffer pointed to by lpBits.
DBB_COPY (4)	Copies bitmap bits from the bitmap pointed to by lpBits to the specified device.
DBB_SETWITHFILLER (8)	Identical to DDB_SET unless the bitmap is larger than 64K bytes (as specified by the lpDevice member of the PBITMAP structure). If the bitmap is larger than 64K bytes, scanlines are never broken across segments. Instead, the last bytes of each segment are used for padding and should be ignored by the driver.

dwCount

Number of bits to copy.

lpBits

Address of a buffer or a bitmap, depending on the value of the fFlags parameter. If fFlags is DBB_SET or DBB_GET, this parameter points to a buffer that contains or receives the bits for the specified bitmap. If fFlags is DBB_COPY, this parameter points to a device bitmap.

The export ordinal for this function is 30.

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

When the fFlags parameter is set to DBB_COPY (4), the dwCount parameter passed from GDI is set to 0 and should be ignored by the driver. In this case, the driver should copy all of the bitmap pointed to by lpBits to the bitmap that lpDevice points to.

See Also

PDEVICE, PBITMAP, GDIINFO