Função CLIPOBJ_bEnum (winddi.h)
A função CLIPOBJ_bEnum enumera um lote de retângulos de uma região de clipe especificada; uma chamada anterior para CLIPOBJ_cEnumStart determina a ordem da enumeração.
Sintaxe
ENGAPI BOOL CLIPOBJ_bEnum(
[in] CLIPOBJ *pco,
[in] ULONG cj,
[out] ULONG *pul
);
Parâmetros
[in] pco
Ponteiro para uma estrutura CLIPOBJ que descreve a região do clipe que deve ser enumerada.
[in] cj
Especifica o tamanho, em bytes, do buffer apontado por pv.
[out] pul
Ponteiro para o buffer que receberá dados sobre a região de clipe em uma estrutura ENUMRECTS .
Retornar valor
O valor retornado será TRUE se o driver precisar chamar essa função novamente para obter mais dados de enumeração ou FALSE se a enumeração for concluída. É possível que CLIPOBJ_bEnum retorne TRUE com o número de retângulos de recorte igual a zero. Nesses casos, o driver deve chamar CLIPOBJ_bEnum novamente sem tomar nenhuma ação.
Comentários
Uma possível estrutura de loop para chamar essa função segue:
do {
bMore = CLIPOBJ_bEnum(pco, sizeof(buffer), &buffer.c);
for (i = 0; i < buffer.c; i++) {
.
.
.
}
} while (bMore);
A contagem de objetos gravados no buffer é gravada no próprio buffer.
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 |