Função BRUSHOBJ_pvGetRbrush (winddi.h)
A função BRUSHOBJ_pvGetRbrush recupera um ponteiro para a realização do driver de um pincel especificado.
Sintaxe
ENGAPI PVOID BRUSHOBJ_pvGetRbrush(
BRUSHOBJ *pbo
);
Parâmetros
pbo
Ponteiro para a estrutura BRUSHOBJ cuja realização é solicitada.
Retornar valor
O valor retornado será um ponteiro para o pincel realizado se a função for bem-sucedida. Se o pincel não puder ser realizado, o valor retornado será nulo e um código de erro será registrado.
Comentários
BRUSHOBJ_pvGetRbrush é chamado quando o pincel é um pincel padrão que ainda não foi realizado; ou seja, é chamado quando o membro iSolidColor da estrutura BRUSHOBJ é 0xFFFFFFFF e o membro pvRbrush é nulo.
Se o pincel não tiver sido realizado quando BRUSHOBJ_pvGetRbrush for chamado, a GDI chamará a função DrvRealizeBrush fornecida pelo driver para obter a realização do pincel pelo driver. Como aceleração, o GDI armazena em cache essa realização no membro pvRbrush da estrutura BRUSHOBJ. Em seguida, quando um aplicativo reutiliza esse pincel para outra operação de desenho, o driver não precisa chamar BRUSHOBJ_pvGetRbrush novamente.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | winddi.h (inclua Winddi.h) |
| Biblioteca | Win32k.lib |
| DLL | Win32k.sys |