Función GdiSetBatchLimit (wingdi.h)

  • Artículo

La función GdiSetBatchLimit establece el número máximo de llamadas de función que se pueden acumular en el lote actual del subproceso que realiza la llamada. El sistema vacía el lote actual cada vez que se supera este límite.

Sintaxis

DWORD GdiSetBatchLimit(
  [in] DWORD dw
);

Parámetros

[in] dw

Especifica el límite de lote que se va a establecer. Un valor de 0 establece el límite predeterminado. Un valor de 1 deshabilita el procesamiento por lotes.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el límite por lotes anterior.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Solo las funciones de dibujo GDI que devuelven valores booleanos se pueden acumular en el lote actual; llama a cualquier otra función de GDI vacía inmediatamente el lote actual. Si se supera el límite de lotes o se llama a la función GdiFlush , también se vacía el lote actual.

Cuando el sistema acumula una llamada de función, la función devuelve TRUE para indicar que está en el lote. Cuando el sistema vacía el lote actual y ejecuta la función por segunda vez, el valor devuelto es TRUE o FALSE, dependiendo de si la función se realiza correctamente. Este segundo valor devuelto solo se notifica si se usa GdiFlush para vaciar el lote.

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.
 

Requisitos

   
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

GdiFlush

GdiGetBatchLimit

Funciones de dibujo y pintura

Información general sobre la pintura y el dibujo