BRUSHOBJ_pvGetRbrush, fonction (winddi.h)

La fonction BRUSHOBJ_pvGetRbrush récupère un pointeur vers la réalisation par le pilote d’un pinceau spécifié.

Syntaxe

ENGAPI PVOID BRUSHOBJ_pvGetRbrush(
  BRUSHOBJ *pbo
);

Paramètres

pbo

Pointeur vers la structure BRUSHOBJ dont la réalisation est demandée.

Valeur retournée

La valeur de retour est un pointeur vers le pinceau réalisé si la fonction réussit. Si le pinceau ne peut pas être réalisé, la valeur de retour est null et un code d’erreur est journalisé.

Remarques

BRUSHOBJ_pvGetRbrush est appelé lorsque le pinceau est un pinceau à motif qui n’a pas encore été réalisé ; autrement dit, il est appelé lorsque le membre iSolidColor de la structure BRUSHOBJ est 0xFFFFFFFF et que le membre pvRbrush a la valeur Null.

Si le pinceau n’a pas été réalisé lorsque BRUSHOBJ_pvGetRbrush est appelé, GDI appelle la fonction DrvRealizeBrush fournie par le pilote pour obtenir la réalisation du pinceau par le pilote. En guise d’accélération, GDI met en cache cette réalisation dans le membre pvRbrush de la structure BRUSHOBJ. Ensuite, lorsqu’une application réutilise ce pinceau pour une autre opération de dessin, le pilote n’a pas besoin d’appeler à nouveau BRUSHOBJ_pvGetRbrush .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Universal
En-tête	winddi.h (inclure Winddi.h)
Bibliothèque	Win32k.lib
DLL	Win32k.sys

Voir aussi

BRUSHOBJ

BRUSHOBJ_pvAllocRbrush

DrvRealizeBrush