Função WNDOBJ_bEnum (winddi.h)
A função WNDOBJ_bEnum obtém um lote de retângulos da região visível de uma janela.
Sintaxe
ENGAPI BOOL WNDOBJ_bEnum(
WNDOBJ *pwo,
ULONG cj,
ULONG *pul
);
Parâmetros
pwo
Ponteiro para uma estrutura WNDOBJ criada por uma chamada para EngCreateWnd.
cj
Especifica o tamanho, em bytes, do buffer apontado por pul. O GDI não escreverá além desse limite.
pul
Ponteiro para o buffer no qual uma estrutura do formulário a seguir deve ser gravada. Nessa estrutura, c é uma contagem dos retângulos retornados e arcl é uma matriz de retângulos:
typedef struct _ENUMRECTS{
ULONG c;
RECTL arcl[]
} ENUMRECTS;
Valor retornado
O valor retornado será TRUE se houver mais dados a serem enumerados e o driver deverá repetir a chamada. Ele será FALSE se a enumeração estiver concluída.
Comentários
A ordem de enumeração é determinada pela chamada para WNDOBJ_cEnumStart.
Segue-se uma possível estrutura de loop para chamar essa função.
do {
bMore = WNDOBJ_bEnum(pwo, sizeof(buffer), &buffer.c);
for (i = 0; i < buffer.c; i++) {
// Process the data
}
} while (bMore);
WNDOBJ_bEnum deve ser chamado apenas pela função de retorno de chamada fornecida ao GDI pela função EngCreateWnd ou pelas funções DDI gráficas que recebem um WNDOBJ.
Requisitos
| 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 |