Função WNDOBJ_cEnumStart (winddi.h)
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 |