Función DrvRealizeBrush (winddi.h)

Artículo
03/04/2024

La función DrvRealizeBrush solicita que el controlador obtenga un pincel especificado para una superficie especificada.

Sintaxis

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

Puntero a la estructura BRUSHOBJ que se va a realizar. Todos los demás parámetros, excepto el caso de especificatarget, se pueden consultar desde este objeto. Las especificaciones de parámetro se proporcionan como una optimización. Este parámetro solo se usa como parámetro para BRUSHOBJ_pvAllocRbrush, que asigna la memoria para el pincel realizado.

[in, out] psoTarget

Puntero a la estructura SURFOBJ para la que se va a realizar el pincel. Esta superficie puede ser la superficie física del dispositivo, un mapa de bits de formato de dispositivo o un mapa de bits de formato estándar.

[in] psoPattern

Puntero a la estructura SURFOBJ que describe el patrón del pincel. Para un dispositivo ráster, se trata de un mapa de bits. Para un dispositivo vectorial, esta es una de las superficies de patrón proporcionadas por DrvEnablePDEV.

[in, optional] psoMask

Puntero a una estructura SURFOBJ que describe una máscara de transparencia para el pincel. Se trata de un mapa de bits de 1 bits por píxel que tiene la misma extensión que el patrón. Una máscara de cero significa que el píxel se considera un píxel de fondo para el pincel. (En el modo de fondo transparente, los píxeles de fondo no se ven afectados en un relleno). Los trazadores pueden omitir este parámetro porque nunca dibujan información de fondo.

[in] pxlo

Puntero a una estructura XLATEOBJ que define la interpretación de los colores en el patrón. Si pxlo es NULL, no se necesita ninguna traducción. Se puede llamar a una rutina de servicio XLATEOBJ_Xxx para traducir los colores a los índices de color del dispositivo. Los dispositivos vectoriales deben traducir el color cero a través de XLATEOBJ para obtener el color de primer plano del pincel.

[in] iHatch

Especificasis es uno de los pinceles de sombreado devueltos por DrvEnablePDEV. Esto es true si el valor de este parámetro es menor que HS_DDI_MAX, que se define en winddi.h.

Valor devuelto

El valor devuelto es TRUE si el pincel se ha realizado correctamente. De lo contrario, es FALSE y se registra un código de error.

Comentarios

Para realizar un pincel, el controlador convierte un pincel GDI en un formulario que se puede usar internamente. Un pincel realizado contiene información específica del dispositivo necesaria para acelerar el dibujo mediante el pincel.

La realización del controlador de un pincel se escribe en el búfer asignado por una llamada a BRUSHOBJ_pvAllocRbrush.

DrvRealizeBrush es necesario para un controlador que realice cualquier dibujo en cualquier superficie.