Функция BRUSHOBJ_pvGetRbrush (winddi.h)

Функция BRUSHOBJ_pvGetRbrush извлекает указатель на реализацию указанной кисти драйвера.

Синтаксис

ENGAPI PVOID BRUSHOBJ_pvGetRbrush(
  BRUSHOBJ *pbo
);

Параметры

pbo

Указатель на структуру BRUSHOBJ , реализация которой запрашивается.

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

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

Комментарии

BRUSHOBJ_pvGetRbrush вызывается, если кисть является еще не реализованной кистью шаблона; то есть вызывается, когда элемент iSolidColor структуры BRUSHOBJ 0xFFFFFFFF, а член pvRbrush имеет значение NULL.

Если кисть не была реализована при вызове BRUSHOBJ_pvGetRbrush , GDI вызывает предоставленную драйвером функцию DrvRealizeBrush , чтобы получить реализацию кисти драйвером. В качестве ускорения GDI кэширует эту реализацию в члене pvRbrush структуры BRUSHOBJ. Затем, когда приложение повторно использует эту кисть для другой операции рисования, драйверу не нужно снова вызывать BRUSHOBJ_pvGetRbrush .

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа	Универсальное
Верхняя часть	winddi.h (включая Winddi.h)
Библиотека	Win32k.lib
DLL	Win32k.sys

См. также раздел

BRUSHOBJ

BRUSHOBJ_pvAllocRbrush

DrvRealizeBrush