Funzione GdiSetBatchLimit (wingdi.h)
La funzione GdiSetBatchLimit imposta il numero massimo di chiamate di funzione che possono essere accumulate nel batch corrente del thread chiamante. Il sistema scarica il batch corrente ogni volta che viene superato questo limite.
Sintassi
DWORD GdiSetBatchLimit(
[in] DWORD dw
);
Parametri
[in] dw
Specifica il limite di batch da impostare. Il valore 0 imposta il limite predefinito. Il valore 1 disabilita l'invio in batch.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è il limite batch precedente.
Se la funzione ha esito negativo, il valore restituito è zero.
Commenti
Solo le funzioni di disegno GDI che restituiscono valori booleani possono essere accumulate nel batch corrente; chiama a qualsiasi altra funzione GDI scarica immediatamente il batch corrente. Il superamento del limite di batch o la chiamata alla funzione GdiFlush scarica anche il batch corrente.
Quando il sistema accumula una chiamata di funzione, la funzione restituisce TRUE per indicare che si trova nel batch. Quando il sistema scarica il batch corrente ed esegue la funzione per la seconda volta, il valore restituito è TRUE o FALSE, a seconda che la funzione abbia esito positivo. Questo secondo valore restituito viene segnalato solo se GdiFlush viene usato per scaricare il batch.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wingdi.h (include Windows.h) |
| Libreria | Gdi32.lib |
| DLL | Gdi32.dll |