Funzione GdiGetBatchLimit (wingdi.h)

La funzione GdiGetBatchLimit restituisce 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 GdiGetBatchLimit();

Valore restituito

Se la funzione ha esito positivo, il valore restituito è il limite batch.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Il limite batch viene impostato usando la funzione GdiSetBatchLimit . L'impostazione del limite su 1 disabilita in modo efficace l'invio in batch.

Solo le funzioni di disegno GDI che restituiscono valori booleani possono essere raggruppate; 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 esegue un batch di una chiamata di funzione, la funzione restituisce TRUE. Il valore restituito effettivo per la funzione viene segnalato solo se GdiFlush viene usato per scaricare il batch.

Nota Il limite batch viene mantenuto separatamente per ogni thread. Per disabilitare completamente l'invio in batch, chiamare GdiSetBatchLimit (1) durante l'inizializzazione di ogni thread.

 

Requisiti

Requisito	Valore
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

Vedi anche

GdiFlush

GdiSetBatchLimit

Funzioni di disegno e disegno

Panoramica di disegno e disegno