BRUSHOBJ_pvAllocRbrush (Windows Embedded CE 6.0)

1/6/2010

This function allocates memory that the display driver requires for realization of a specified brush.

Syntax

PVOID BRUSHOBJ_pvAllocRbrush(
  BRUSHOBJ* pbo,
  ULONG cj
);

Parameters

  • pbo
    [in] Pointer to the BRUSHOBJ structure for which the realization is to be allocated.
  • cj
    [in] Size, in bytes, required for the realization.

Return Value

If the function call succeeds, this function returns a pointer to the allocated memory. Otherwise, this function returns NULL and logs an error code.

Remarks

The BRUSHOBJ_pvAllocRbrush function allocates memory for brush realization. GDI manages the memory and discards it when the brush is no longer needed.

An implementation of a brush realization should call the BRUSHOBJ_pvAllocRbrush function after calling the DrvRealizeBrush function.

Requirements

Header winddi.h
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, Ddi_tvia5_lib.lib
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

GDI Functions for Display Drivers
DrvRealizeBrush