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 |
|---|---|
|
GDI usará el contenido de la estructura PERBANDINFO. |
|
GDI omitirá el contenido de la estructura PERBANDINFO. |
|
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) |