Функции GDI Win-32, страница 4

Параметры

Hdc

Обработка контекста устройства. Если значение iUsage - DIB_PAL_COLORS, функция использует этот контекст устройством логической палитры (logical palette) к инициализации цвета аппаратно-независимых побитовых отображений.

Pbmi

Указатель на структуру BITMAPINFO, которая определяет различные признаки аппаратно-независимого побитового отображения.

IUsage

Определяет тип данных, содержащихся в bmiColors; указывает на  члены структуры BITMAPINFO, указанной pbmi: логические индексы палитры или литерал RGB значения. Следующие значения определены:

Значение          Значение

DIB_PAL_COLORS        16-битный адрес члена BmiColors  с логической палитрой контекста устройства, указанного в hdc.

DIB_RGB_COLORS       Структура BITMAPINFO содержит множество литерала RGB значения.

PpvBits

Указатель на переменную, которая получает адрес значений  аппаратно-независимых побитовых отображений.

HSection

Обработка отображения объекта файла не позволяет использовать функцию, чтобы создать аппаратно-независимое побитовое отображение. Этот параметр может быть нулевым.

Если hSection - не нулевой указатель, должен обрабатывать  отображение объекта файла..

Если hSection - не пустой указатель, функция CreateDIBSection располагает значения  побитовых отображений в dwOffset, в отображении объекта файла. Можно восстановить позже обработку hSection,  вызывая функцию GetObject с возвращенным значением CreateDIBSection.

Если hSection нулевой, операционная система размещает память для аппаратно-независимого побитового отображения. В этом случае функция CreateDIBSection игнорирует dwOffset параметр. Позже нельзя обратиться к этой памяти: член структуры dshSection, заполненной DIBSECTION,  вызывая функцию GetObject будет нулевой.

DwOffset

Определяет смещение с начала отображения объекта файла, упомянутого hSection, с начала хранения значений побитовых отображений. Эта значение игнорируется, если hSection нулевой. Значение побитовых отображений выровнены на границах двойного слова, так что dwOffset должен быть многократный  размера DWORD.

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

Если функция успешна, возвращаемое значение - обработка аппаратно-независимого побитового отображения, и *ppvBits указывает на значения битов побитового отображения.

Если функция выполнена неуспешно, возвращаемое значение нулевое, и *ppvBits нулевой. Замечания

Как отмечено выше, если hSection пустой, операционная система размещает память для аппаратно-независимого побитового отображения. Операционная система закрывает доступ к той памяти, когда Вы позже удаляете аппаратно-независимое побитовое отображение,  вызывая функцию DeleteObject. Если hSection - не пустой указатель, Вы должны закрыть приложение,  hSection память общается с собой после запроса DeleteObject для удаления побитового отображения. 

Функция CreateDiscardableBitmap создает побитовое отображение, которое является совместимым с указанным устройством. Побитовое отображение имеет тот же самый формат и ту же самую цветную палитру как устройство. Для использования можно выбирать это побитовое отображение как поток побитовых отображений для устройства памяти, которое является совместимым с указанным устройством.

Функция CreateDiscardableBitmap включена только для совместимости с более ранними версиями Windows.

HBITMAP CreateDiscardableBitmap (

HDC hdc,      // обработка контекста устройства 

Int nWidth,     // ширина побитового отображения

Int nHeight     // высота побитового отображения

);       

Параметры

Hdc

Опознает контекст устройства.

NWidth

Определяет ширину побитовое отображение, в битах.

NHeight

Определяет высоту побитовое отображение.

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

Если функция успешна, возвращаемое значение обрабатывает побитовое отображение

Если функция выполнена неуспешно, возвращаемое значение нулевое.

Замечания

Когда Вы больше не нуждаетесь в побитовом отображении, вызовите функцию DeleteObject, чтобы удалить его.