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

Weitere Informationen

BRUSHOBJ

BRUSHOBJ_pvAllocRbrush

DrvRealizeBrush