función BRUSHOBJ_pvGetRbrush (winddi.h)

La función BRUSHOBJ_pvGetRbrush recupera un puntero a la realización del controlador de un pincel especificado.

Sintaxis

ENGAPI PVOID BRUSHOBJ_pvGetRbrush(
  BRUSHOBJ *pbo
);

Parámetros

pbo

Puntero a la estructura BRUSHOBJ cuya realización se solicita.

Valor devuelto

El valor devuelto es un puntero al pincel realizado si la función es correcta. Si no se puede realizar el pincel, el valor devuelto es NULL y se registra un código de error.

Comentarios

BRUSHOBJ_pvGetRbrush se llama cuando el pincel es un pincel de patrón que aún no se ha realizado; es decir, se llama cuando el miembro iSolidColor de la estructura BRUSHOBJ es 0xFFFFFFFF y el miembro pvRbrush es null.

Si no se ha realizado el pincel cuando se llama a BRUSHOBJ_pvGetRbrush , GDI llama a la función DrvRealizeBrush proporcionada por el controlador para obtener la realización del pincel del controlador. Como aceleración, GDI almacena en caché esta realización en el miembro pvRbrush de la estructura BRUSHOBJ. A continuación, cuando una aplicación reutiliza este pincel para otra operación de dibujo, el controlador no tiene que llamar a BRUSHOBJ_pvGetRbrush de nuevo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Universal
Encabezado	winddi.h (incluya Winddi.h)
Library	Win32k.lib
Archivo DLL	Win32k.sys

Consulte también

BRUSHOBJ

BRUSHOBJ_pvAllocRbrush

DrvRealizeBrush