BRUSHOBJ_pvAllocRbrush function (winddi.h)

The BRUSHOBJ_pvAllocRbrush function allocates memory for the driver's realization of a specified brush.

Syntax

ENGAPI PVOID BRUSHOBJ_pvAllocRbrush(
  BRUSHOBJ *pbo,
  ULONG    cj
);

Parameters

pbo

Pointer to the BRUSHOBJ structure for which the realization is to be allocated.

cj

Specifies the size, in bytes, required for the realization.

Return value

The return value is a pointer to the allocated memory if the function is successful. Otherwise, it is null, and an error code is logged.

Remarks

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

This function should be called only by an implementation of a brush realization following a call to DrvRealizeBrush.

Requirements

Requirement Value
Minimum supported client Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform Universal
Header winddi.h (include Winddi.h)
Library Win32k.lib
DLL Win32k.sys

See also

BRUSHOBJ

DrvRealizeBrush