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

Confira também

BRUSHOBJ

BRUSHOBJ_pvAllocRbrush

DrvRealizeBrush