Función GdiFlush (wingdi.h)

  • Artículo

La función GdiFlush vacía el lote actual del subproceso que llama.

Sintaxis

BOOL GdiFlush();

Valor devuelto

Si todas las funciones del lote actual se realizan correctamente, el valor devuelto es distinto de cero.

Si no todas las funciones del lote actual se realizan correctamente, el valor devuelto es cero, lo que indica que al menos una función devolvió un error.

Comentarios

El procesamiento por lotes mejora el rendimiento del dibujo al minimizar la cantidad de tiempo necesario para llamar a funciones de dibujo GDI que devuelven valores booleanos. El sistema acumula los parámetros para las llamadas a estas funciones en el lote actual y, a continuación, llama a las funciones cuando el lote se vacía mediante cualquiera de los siguientes medios:

  • Llamar a la función GdiFlush .
  • Alcanzar o superar el límite de lote establecido por la función GdiSetBatchLimit .
  • Rellenar los búferes de procesamiento por lotes.
  • Llamar a cualquier función GDI que no devuelva un valor booleano.
El valor devuelto de GdiFlush solo se aplica a las funciones del lote en el momento en que se llama a GdiFlush . Los errores que se producen cuando el lote se vacía por cualquier otro medio nunca se notifican.

La función GdiGetBatchLimit devuelve el límite de lotes.

Nota El límite por lotes se mantiene para cada subproceso por separado. Para deshabilitar completamente el procesamiento por lotes, llame a GdiSetBatchLimit (1) durante la inicialización de cada subproceso.
 
Una aplicación debe llamar a GdiFlush antes de que un subproceso desaparezca si existe la posibilidad de que haya llamadas de función pendientes en la cola de lotes de gráficos. El sistema no ejecuta estas funciones por lotes cuando un subproceso desaparece.

Una aplicación multiproceso que serializa el acceso a objetos GDI con una exclusión mutua debe asegurarse de vaciar la cola por lotes de GDI llamando a GdiFlush a medida que cada subproceso libera la propiedad del objeto GDI. Esto evita colisiones de los objetos GDI (contextos de dispositivo, metarchivos, etc.).

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también

GdiGetBatchLimit

GdiSetBatchLimit

Funciones de dibujo y pintura

Información general sobre la pintura y el dibujo