Visual C++. Описание стандартных классов - GetBitmapBits

ОГЛАВЛЕНИЕ


GetBitmapBits

DWORD GetBitmapBits(DWORD dwCount, LPVOID lpBits) const;

Возвращаемое значение

Нулевое значение в случае возникновения ошибки, и скопированное количество байт в битовом образе в противном случае.

Аргументы

  • dwCount - определяет количество байт, которые необходимо скопировать.
  • lpBits - указатель на буфер, в который будет записан битовый образ. Битовый образ представляет собой байтовый массив. Хранение информации производится по линиям горизонтальной развертки, для хранения которых используются 16-битные структуры. Поэтому, если битовый образ содержит нечетное количество столбцов, и для хранения информации о цвете каждого из элементов изображения используется нечетное количество байт, объем памяти, необходимый для хранения одной строки горизонтальной развертки будет на один байт превышать ее действительный размер.

Описание

Копирует битовый образ из объекта класса CBitmap в буфер, на который указывает аргумент lpBits. Аргумент dwCount определяет количество байт, которое необходимо скопировать в данный буфер. Для определения корректного значения аргумента dwCount следует вызывать функцию CGdiObject::GetObject для данного объекта класса битового образа.