Función GdiSetBatchLimit (wingdi.h)

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.

Requisitos

Consulte también

GdiFlush

GdiGetBatchLimit

Funciones de dibujo y pintura

Información general sobre la pintura y el dibujo