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.

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

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

GdiGetBatchLimit

Funzioni di disegno e disegno

Panoramica di disegno e disegno