Função DrvRealizeBrush (winddi.h)

Artigo
08/27/2023

A função DrvRealizeBrush solicita que o driver realize um pincel especificado para uma superfície especificada.

Sintaxe

BOOL DrvRealizeBrush(
  [in]           BRUSHOBJ *pbo,
  [in, out]      SURFOBJ  *psoTarget,
  [in]           SURFOBJ  *psoPattern,
  [in, optional] SURFOBJ  *psoMask,
  [in]           XLATEOBJ *pxlo,
  [in]           ULONG    iHatch
);

Parâmetros

[in] pbo

Ponteiro para a estrutura BRUSHOBJ que deve ser realizada. Todos os outros parâmetros, exceto psoTarget, podem ser consultados desse objeto. As especificações de parâmetro são fornecidas como uma otimização. Esse parâmetro é melhor usado apenas como um parâmetro para BRUSHOBJ_pvAllocRbrush, que aloca a memória para o pincel realizado.

[in, out] psoTarget

Ponteiro para a estrutura SURFOBJ para a qual o pincel deve ser realizado. Essa superfície pode ser a superfície física do dispositivo, um bitmap de formato de dispositivo ou um bitmap de formato padrão.

[in] psoPattern

Ponteiro para a estrutura SURFOBJ que descreve o padrão do pincel. Para um dispositivo raster, este é um bitmap. Para um dispositivo vetor, essa é uma das superfícies de padrão fornecidas por DrvEnablePDEV.

[in, optional] psoMask

Ponteiro para uma estrutura SURFOBJ que descreve uma máscara de transparência para o pincel. Esse é um bitmap de 1 bit por pixel que tem a mesma extensão que o padrão. Uma máscara de zero significa que o pixel é considerado um pixel de plano de fundo para o pincel. (No modo de fundo transparente, os pixels de plano de fundo não são afetados em um preenchimento.) Os plotadores podem ignorar esse parâmetro porque nunca desenham informações em segundo plano.

[in] pxlo

Ponteiro para uma estrutura XLATEOBJ que define a interpretação de cores no padrão. Se pxlo for NULL, nenhuma tradução será necessária. Uma rotina de serviço XLATEOBJ_Xxx pode ser chamada para traduzir as cores para índices de cor do dispositivo. Os dispositivos vetoriais devem traduzir a cor zero por meio do XLATEOBJ para obter a cor de primeiro plano do pincel.

[in] iHatch

Especifica se psoPattern é um dos pincéis de escotilha retornados por DrvEnablePDEV. Isso será verdadeiro se o valor desse parâmetro for menor que HS_DDI_MAX, que é definido em winddi.h.

Retornar valor

O valor retornado será TRUE se o pincel tiver sido realizado com êxito. Caso contrário, ele é FALSE e um código de erro é registrado.

Comentários

Para realizar um pincel, o driver converte um pincel GDI em um formulário que pode ser usado internamente. Um pincel realizado contém informações específicas do dispositivo necessárias para o dispositivo acelerar o desenho usando o pincel.

A realização do driver de um pincel é gravada no buffer alocado por uma chamada para BRUSHOBJ_pvAllocRbrush.

DrvRealizeBrush é necessário para um driver que faz qualquer desenho em qualquer superfície.