Compartilhar via

Função GdiFlush (wingdi.h)

  • Artigo

A função GdiFlush libera o lote atual do thread de chamada.

Sintaxe

BOOL GdiFlush();

Retornar valor

Se todas as funções no lote atual tiverem êxito, o valor retornado será diferente de zero.

Se nem todas as funções no lote atual forem bem-sucedidas, o valor retornado será zero, indicando que pelo menos uma função retornou um erro.

Comentários

O envio em lote melhora o desempenho do desenho minimizando o tempo necessário para chamar funções de desenho GDI que retornam valores boolianos. O sistema acumula os parâmetros para chamadas a essas funções no lote atual e, em seguida, chama as funções quando o lote é liberado por qualquer um dos seguintes meios:

  • Chamando a função GdiFlush .
  • Atingir ou exceder o limite de lote definido pela função GdiSetBatchLimit .
  • Preenchendo os buffers de envio em lote.
  • Chamar qualquer função GDI que não retorne um valor booliano.
O valor retornado de GdiFlush aplica-se somente às funções no lote no momento em que GdiFlush é chamado. Erros que ocorrem quando o lote é liberado por outros meios nunca são relatados.

A função GdiGetBatchLimit retorna o limite do 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.
 
Um aplicativo deve chamar GdiFlush antes que um thread desapareça se houver a possibilidade de haver chamadas de função pendentes na fila do lote de gráficos. O sistema não executa essas funções em lote quando um thread desaparece.

Um aplicativo multithread que serializa o acesso a objetos GDI com um mutex deve garantir a liberação da fila de lote GDI chamando GdiFlush à medida que cada thread libera a propriedade do objeto GDI. Isso impede colisões dos objetos GDI (contextos de dispositivo, metarquivos e assim por diante).

Requisitos

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

GdiGetBatchLimit

GdiSetBatchLimit

Funções de pintura e desenho

Visão geral de pintura e desenho