Função GdiSetBatchLimit (wingdi.h)

A função GdiSetBatchLimit define o número máximo de chamadas de função que podem ser acumuladas no lote atual do thread de chamada. O sistema libera o lote atual sempre que esse limite é excedido.

Sintaxe

DWORD GdiSetBatchLimit(
  [in] DWORD dw
);

Parâmetros

[in] dw

Especifica o limite de lote a ser definido. Um valor de 0 define o limite padrão. Um valor de 1 desabilita o envio em lote.

Valor retornado

Se a função for bem-sucedida, o valor retornado será o limite de lote anterior.

Se a função falhar, o valor retornado será zero.

Comentários

Somente funções de desenho GDI que retornam valores boolianos podem ser acumuladas no lote atual; chama para outras funções GDI imediatamente liberam o lote atual. Exceder o limite do lote ou chamar a função GdiFlush também libera o lote atual.

Quando o sistema acumula uma chamada de função, a função retorna TRUE para indicar que está no lote. Quando o sistema libera o lote atual e executa a função pela segunda vez, o valor retornado é TRUE ou FALSE, dependendo se a função é bem-sucedida. Esse segundo valor retornado será relatado somente se GdiFlush for usado para liberar o lote.

Nota O limite de lote é mantido para cada thread separadamente. Para desabilitar completamente o envio em lote, chame GdiSetBatchLimit (1) durante a inicialização de cada thread.

 

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll

Confira também

GdiFlush

GdiGetBatchLimit

Funções de pintura e desenho

Visão geral de pintura e desenho