BRUSHOBJ_pvGetRbrush (Windows CE 5.0)
This function retrieves a pointer to the realization of a specified brush.
PVOID BRUSHOBJ_pvGetRbrush( BRUSHOBJ* pbo,);
Parameters
- pbo
[in] Pointer to the BRUSHOBJ structure containing the realization.
Return Values
If the function call succeeds, this function returns a pointer to the realized brush. Otherwise, this function returns NULL and logs an error code.
Remarks
The BRUSHOBJ_pvGetRbrush function is called when the brush is a pattern brush that is not yet realized. In other words, the BRUSHOBJ_pvGetRbrush function is called if, in the BRUSHOBJ structure, the value of the iSolidColor member is 0xFFFFFFFF and the value of the pvRbrush member is NULL. If the brush is not realized when the BRUSHOBJ_pvGetRbrush function is called, GDI calls the DrvRealizeBrush function to obtain the realization of the brush.
To improve performance, GDI caches this realization in the pvRbrush member of the BRUSHOBJ structure. If an application uses this brush for another drawing operation, the driver does not need to call the BRUSHOBJ_pvGetRbrush function again.
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Winddi.h.
Link Library: Ddi_ati_lib.lib, Ddi_flat_lib.lib, Ddi_gx_lib.lib, Ddi_mq200_lib.lib, Ddi_nop_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, or Ddi_tvia5_lib.lib.
See Also
GDI Functions for Display Drivers | BRUSHOBJ_pvAllocRbrush | DrvRealizeBrush
Send Feedback on this topic to the authors