BRUSHOBJ_pvGetRbrush-Funktion (winddi.h)
Die BRUSHOBJ_pvGetRbrush-Funktion ruft einen Zeiger auf die Realisierung eines angegebenen Pinsels durch den Treiber ab.
Syntax
ENGAPI PVOID BRUSHOBJ_pvGetRbrush(
BRUSHOBJ *pbo
);
Parameter
pbo
Zeiger auf die BRUSHOBJ-Struktur , deren Realisierung angefordert wird.
Rückgabewert
Der Rückgabewert ist ein Zeiger auf den realisierten Pinsel, wenn die Funktion erfolgreich ist. Wenn der Pinsel nicht realisiert werden kann, ist der Rückgabewert NULL, und ein Fehlercode wird protokolliert.
Hinweise
BRUSHOBJ_pvGetRbrush wird aufgerufen, wenn der Pinsel ein Musterpinsel ist, der noch nicht realisiert wurde; Das heißt, es wird aufgerufen, wenn das iSolidColor-Element der BRUSHOBJ-Struktur 0xFFFFFFFF und das pvRbrush-Element NULL ist.
Wenn der Pinsel beim Aufrufen BRUSHOBJ_pvGetRbrush nicht realisiert wurde, ruft GDI die vom Treiber bereitgestellte DrvRealizeBrush-Funktion auf, um die Realisierung des Pinsels durch den Treiber zu erhalten. Als Beschleunigung speichert GDI diese Erkenntnis im pvRbrush-Member der BRUSHOBJ-Struktur zwischen. Wenn eine Anwendung diesen Pinsel dann für einen anderen Zeichnungsvorgang wiederverwendet, muss der Treiber BRUSHOBJ_pvGetRbrush nicht erneut aufrufen .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Universell |
| Header | winddi.h (einschließlich Winddi.h) |
| Bibliothek | Win32k.lib |
| DLL | Win32k.sys |