UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:winddi.BRUSHOBJ_pvGetRbrush |
BRUSHOBJ_pvGetRbrush function (winddi.h) |
The BRUSHOBJ_pvGetRbrush function retrieves a pointer to the driver's realization of a specified brush. |
|
display\brushobj_pvgetrbrush.htm |
display |
3f3e5acb-f984-4571-9555-f6b383ddb6a7 |
12/05/2018 |
BRUSHOBJ_pvGetRbrush, BRUSHOBJ_pvGetRbrush function [Display Devices], display.brushobj_pvgetrbrush, gdifncs_a19def34-749c-4e98-b03e-1b35f4e1f761.xml, winddi/BRUSHOBJ_pvGetRbrush |
winddi.h |
Winddi.h |
Universal |
Available in Windows 2000 and later versions of the Windows operating systems. |
Win32k.lib |
Win32k.sys |
Windows |
19H1 |
|
|
|
|
|
|
The BRUSHOBJ_pvGetRbrush function retrieves a pointer to the driver's realization of a specified brush.
Pointer to the BRUSHOBJ structure whose realization is requested.
The return value is a pointer to the realized brush if the function is successful. If the brush cannot be realized, the return value is null and an error code is logged.
BRUSHOBJ_pvGetRbrush is called when the brush is a pattern brush that has not yet been realized; that is, it is called when the iSolidColor member of the BRUSHOBJ structure is 0xFFFFFFFF and the pvRbrush member is null.
If the brush has not been realized when BRUSHOBJ_pvGetRbrush is called, GDI calls the driver-supplied DrvRealizeBrush function to obtain the driver's realization of the brush. As an acceleration, GDI caches this realization in the pvRbrush member of the BRUSHOBJ structure. Then, when an application reuses this brush for another drawing operation, the driver doesn't have to call BRUSHOBJ_pvGetRbrush again.