Функция DrvFillPath (winddi.h)

Статья
08/27/2023

Функция DrvFillPath является необязательной точкой входа для обработки заполнения закрытых путей.

Синтаксис

BOOL DrvFillPath(
  [in, out] SURFOBJ  *pso,
  [in]      PATHOBJ  *ppo,
  [in]      CLIPOBJ  *pco,
  [in]      BRUSHOBJ *pbo,
  [in]      POINTL   *pptlBrushOrg,
  [in]      MIX      mix,
  [in]      FLONG    flOptions
);

Параметры

[in, out] pso

Указатель на структуру SURFOBJ , которая определяет поверхность для рисования.

[in] ppo

Указатель на структуру PATHOBJ , которая определяет путь для заполнения. Подпрограммы службы PATHOBJ_Xxx предоставляются для перечисления линий, кривых Безье и других данных, составляющих путь.

[in] pco

Указатель на структуру CLIPOBJ . Подпрограммы службы CLIPOBJ_Xxx предоставляются для перечисления области клипа в виде набора прямоугольников.

[in] pbo

Указатель на структуру BRUSHOBJ , которая определяет узор и цвета, используемые для заполнения закрытого пути. Этот параметр следует разыменовывать, только если операция заполнения, указанная в mix , требует использования кисти. Например, если для mix задано значение BLACKNESS, pbo не определяется и не следует разыменовывать.

[in] pptlBrushOrg

Указатель на структуру POINTL , определяющую источник кисти, которая используется для выравнивания шаблона кисти на устройстве.

[in] mix

Смешанный режим, определяющий операции переднего плана и фоновых растровых операций, используемых для кисти. Дополнительные сведения о смешанном режиме см. в разделе Примечания.

[in] flOptions

Указывает либо FP_WINDINGMODE, указывающее, что должна быть выполнена заливка в режиме обмотки, либо FP_ALTERNATEMODE, указывающая, что должна быть выполнена заливка в режиме чередования. Все остальные флаги следует игнорировать. Дополнительные сведения об этих режимах см. в разделе Режимы заполнения пути.

Возвращаемое значение

Возвращаемое значение равно TRUE , если драйвер может заполнить путь. Если путь или обрезка слишком сложны для обработки драйвером и должен обрабатываться GDI, возвращаемое значение равно FALSE, а код ошибки не регистрируется. Если драйвер сталкивается с непредвиденной ошибкой, например не удается реализовать кисть, возвращаемое значение DDI_ERROR и регистрируется код ошибки.

GDI может вызывать DrvFillPath для заполнения пути на управляемой устройством поверхности. При принятии решения о том, следует ли вызывать эту функцию, GDI сравнивает требования заполнения со следующими флагами в элементе flGraphicsCaps структуры DEVINFO : GCAPS_BEZIERS, GCAPS_ALTERNATEFILL и GCAPS_WINDINGFILL.

Смешанный режим определяет, как входящий шаблон следует смешивать с данными, которые уже находятся на поверхности устройства. Тип данных MIX состоит из двух значений двоичной растровой операции (ROP2), упакованных в один ULONG. Байт наименьшего порядка определяет растровую операцию переднего плана; следующий байт определяет фоновую операцию растра. Дополнительные сведения о кодах растровых операций см. в документации по Microsoft Windows SDK.