Compartir a través de


Función DrvQueryPerBandInfo (winddi.h)

GDI llama a la función DrvQueryPerBandInfo de un archivo DLL de gráficos de impresora antes de empezar a dibujar una banda para una página física, por lo que el controlador puede proporcionar GDI con información específica de banda.

Sintaxis

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

Parámetros

[in] pso

Puntero proporcionado por el autor de la llamada a una estructura SURFOBJ que describe la superficie de dibujo.

[in, out] pbi

Puntero proporcionado por el autor de la llamada a una estructura PERBANDINFO que contiene información predeterminada, que la función puede sobrescribir.

Valor devuelto

La función debe devolver uno de los siguientes valores:

Código devuelto Descripción
Mayor que cero
GDI usará el contenido de la estructura PERBANDINFO.
Cero
GDI omitirá el contenido de la estructura PERBANDINFO.
DDI_ERROR
GDI no dibujará la banda.

Comentarios

Si un archivo DLL de gráficos de impresora usa superficies administradas por GDI y, si admite bandas de superficies, puede proporcionar opcionalmente una función DrvQueryPerBandInfo . GDI llama a la función antes de representar cada banda.

El archivo DLL de gráficos de impresora usa la estructura PERBANDINFO de la función para indicar si se debe volver a dibujar la banda anterior y especificar que se debe escalar la banda. Si un archivo DLL de gráficos de impresora admite bandas, pero no proporciona una función DrvQueryPerBandInfo , GDI no repetirá ni escalará las bandas.

La función DrvQueryPerBandInfo solo se llama durante la reproducción de archivos EMF.

Requisitos

   
Plataforma de destino Escritorio
Encabezado winddi.h (incluya Winddi.h)

Consulte también

DrvNextBand

DrvStartBanding