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

  • Статья

Функция DrvQueryPerBandInfo библиотеки принтеров вызывается GDI перед началом рисования полосы для физической страницы, поэтому драйвер может предоставить GDI сведения, относящиеся к диапазону.

Синтаксис

ULONG DrvQueryPerBandInfo(
  [in]      SURFOBJ     *pso,
  [in, out] PERBANDINFO *pbi
);

Параметры

[in] pso

Предоставленный вызывающим объектом указатель на структуру SURFOBJ , описывающую поверхность рисования.

[in, out] pbi

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

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

Функция должна возвращать одно из следующих значений:

Код возврата Описание
Больше нуля
 GDI будет использовать содержимое структуры PERBANDINFO.
Нуль
 GDI игнорирует содержимое структуры PERBANDINFO.
DDI_ERROR
 GDI не будет рисовать полосу.

Комментарии

Если библиотека DLL для графики принтера использует управляемые GDI поверхности и поддерживает чередование поверхностей, при необходимости она может предоставить функцию DrvQueryPerBandInfo . GDI вызывает функцию перед отрисовкой каждого диапазона.

Библиотека DLL графики принтера использует структуру PERBANDINFO функции, чтобы указать, следует ли перерисовать предыдущую полосу, и указать, что полоса должна быть масштабирована. Если библиотека DLL графики принтера поддерживает чередование, но не предоставляет функцию DrvQueryPerBandInfo , GDI не будет повторять или масштабировать диапазоны.

Функция DrvQueryPerBandInfo вызывается только во время воспроизведения EMF-файлов.

Требования

   
Целевая платформа Персональный компьютер
Верхняя часть winddi.h (включая Winddi.h)

См. также раздел

DrvNextBand

DrvStartBanding