다음을 통해 공유


BRUSHOBJ_pvGetRbrush (Windows CE 5.0)

Send Feedback

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.