GetBitmapBits function (wingdi.h)

The GetBitmapBits function copies the bitmap bits of a specified device-dependent bitmap into a buffer.

Note  This function is provided only for compatibility with 16-bit versions of Windows. Applications should use the GetDIBits function.


LONG GetBitmapBits(
  [in]  HBITMAP hbit,
  [in]  LONG    cb,
  [out] LPVOID  lpvBits


[in] hbit

A handle to the device-dependent bitmap.

[in] cb

The number of bytes to copy from the bitmap into the buffer.

[out] lpvBits

A pointer to a buffer to receive the bitmap bits. The bits are stored as an array of byte values.

Return value

If the function succeeds, the return value is the number of bytes copied to the buffer.

If the function fails, the return value is zero.


Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

Bitmap Functions

Bitmaps Overview