funzione BRUSHOBJ_pvGetRbrush (winddi.h)

La funzione BRUSHOBJ_pvGetRbrush recupera un puntatore alla realizzazione del driver di un pennello specificato.

Sintassi

ENGAPI PVOID BRUSHOBJ_pvGetRbrush(
  BRUSHOBJ *pbo
);

Parametri

pbo

Puntatore alla struttura BRUSHOBJ la cui realizzazione è richiesta.

Valore restituito

Il valore restituito è un puntatore al pennello realizzato se la funzione ha esito positivo. Se il pennello non può essere realizzato, il valore restituito è Null e viene registrato un codice di errore.

Commenti

BRUSHOBJ_pvGetRbrush viene chiamato quando il pennello è un pennello motivo che non è ancora stato realizzato; vale a dire, viene chiamato quando il membro iSolidColor della struttura BRUSHOBJ è 0xFFFFFFFF e il membro pvRbrush è Null.

Se il pennello non è stato realizzato quando viene chiamato BRUSHOBJ_pvGetRbrush , GDI chiama la funzione Drv RealizBrush fornita dal driver per ottenere la realizzazione del pennello da parte del driver. Come accelerazione, GDI memorizza nella cache questa realizzazione nel membro pvRbrush della struttura BRUSHOBJ. Quindi, quando un'applicazione riutilizza questo pennello per un'altra operazione di disegno, il driver non deve chiamare di nuovo BRUSHOBJ_pvGetRbrush .

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione Universale
Intestazione winddi.h (include Winddi.h)
Libreria Win32k.lib
DLL Win32k.sys

Vedi anche

BRUSHOBJ

BRUSHOBJ_pvAllocRbrush

DrvBrush