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 |