BRUSHOBJ_pvGetRbrush 函数 (winddi.h)

  • 项目

BRUSHOBJ_pvGetRbrush 函数检索指向驱动程序实现指定画笔的指针。

语法

ENGAPI PVOID BRUSHOBJ_pvGetRbrush(
  BRUSHOBJ *pbo
);

参数

pbo

指向请求实现的 BRUSHOBJ 结构的指针。

返回值

如果函数成功，则返回值是指向已实现的画笔的指针。 如果无法实现画笔，则返回值为 null，并记录错误代码。

注解

当 画笔是尚未实现的图案画笔时，将调用BRUSHOBJ_pvGetRbrush;也就是说，当 BRUSHOBJ 结构的 iSolidColor 成员0xFFFFFFFF且 pvRbrush 成员为 null 时调用它。

如果在调用 BRUSHOBJ_pvGetRbrush 时尚未实现画笔，GDI 将调用驱动程序提供的 DrvRealizeBrush 函数来获取驱动程序实现画笔的实现。 作为加速，GDI 将此实现缓存在 BRUSHOBJ 结构的 pvRbrush 成员中。 然后，当应用程序将此画笔用于另一个绘图操作时，驱动程序不必再次调用 BRUSHOBJ_pvGetRbrush 。

要求

要求 值
最低受支持的客户端 在 Windows 2000 及更高版本的 Windows 操作系统中可用。
目标平台 通用
标头 winddi.h (包括 Winddi.h)
Library Win32k.lib
DLL Win32k.sys

另请参阅

BRUSHOBJ

BRUSHOBJ_pvAllocRbrush

DrvRealizeBrush