Função WNDOBJ_cEnumStart (winddi.h)

  • Artigo

A função WNDOBJ_cEnumStart é uma função de retorno de chamada que define parâmetros para enumeração de retângulos na região visível de uma janela.

Sintaxe

ENGAPI ULONG WNDOBJ_cEnumStart(
  WNDOBJ *pwo,
  ULONG  iType,
  ULONG  iDirection,
  ULONG  cLimit
);

Parâmetros

pwo

Ponteiro para uma estrutura WNDOBJ criada por uma chamada para EngCreateWnd.

iType

Especifica o tipo de estruturas a serem retornadas por WNDOBJ_bEnum. Esse parâmetro pode ser CT_RECTANGLES, o que significa que a região deve ser enumerada como uma lista de retângulos.

iDirection

Determina a ordem na qual os retângulos são retornados. Essa ordem pode ser essencial quando um DrvBitBlt sobreposto está sendo executado na mesma superfície. Se a ordem não for relevante para o driver de dispositivo, CD_ANY deverá ser especificado. Isso permite que a GDI otimize sua enumeração para regiões complexas. Esse parâmetro pode usar um dos valores a seguir:

Valor Significado
CD_ANY Qualquer pedido conveniente para GDI.
CD_LEFTDOWN Da direita para a esquerda, de cima para baixo.
CD_LEFTUP Da direita para a esquerda, de baixo para cima.
CD_LEFTWARDS Da esquerda para a direita, a direção vertical não está definida.
CD_RIGHTDOWN Da esquerda para a direita, de cima para baixo.
CD_RIGHTUP Da esquerda para a direita, de baixo para cima.
CD_UPWARDS De baixo para cima, a direção horizontal não está definida.

cLimit

É uma indicação de quantos objetos o driver está interessado em armazenar em cache. Isso só é usado para decidir quando parar de contar retângulos enquanto a GDI está calculando o valor retornado para essa função. Se cLimit for zero, a contagem não será feita.

Retornar valor

O valor retornado é uma contagem do número de objetos que seriam enumerados, desde que esse valor seja menor ou igual a cLimit. Se a contagem for maior que cLimit, o valor retornado será 0xFFFFFFFF.

Comentários

A enumeração pode ser reiniciada chamando essa função novamente.

WNDOBJ_cEnumStart deve ser chamado apenas:

  • No contexto da função de retorno de chamada do driver fornecida ao GDI na função EngCreateWnd ou nas funções DDI de gráficos em que um WNDOBJ é fornecido.
  • Quando o thread de chamada tem o bloqueio do dispositivo para garantir que nenhuma alteração na região do cliente ocorra.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Universal
Cabeçalho winddi.h (inclua Winddi.h)
Biblioteca Win32k.lib
DLL Win32k.sys

Confira também

DrvBitBlt

EngCreateWnd

EngLockDriverObj

WNDOBJ

WNDOBJ_bEnum