funzione WNDOBJ_bEnum (winddi.h)

La funzione WNDOBJ_bEnum ottiene un batch di rettangoli dall'area visibile di una finestra.

Sintassi

ENGAPI BOOL WNDOBJ_bEnum(
  WNDOBJ *pwo,
  ULONG  cj,
  ULONG  *pul
);

Parametri

pwo

Puntatore a una struttura WNDOBJ creata da una chiamata a EngCreateWnd.

cj

Specifica le dimensioni, in byte, del buffer a cui punta pul. L'GDI non scriverà oltre questo limite.

pul

Puntatore al buffer in cui deve essere scritta una struttura del formato seguente. In questa struttura c è un conteggio dei rettangoli restituiti e arcl è una matrice di rettangoli:

typedef struct _ENUMRECTS{
    ULONG c;
    RECTL arcl[]
} ENUMRECTS;

Valore restituito

Il valore restituito è TRUE se sono presenti più dati da enumerare e il driver deve ripetere la chiamata. È FALSE se l'enumerazione è completa.

Commenti

L'ordine di enumerazione è determinato dalla chiamata a WNDOBJ_cEnumStart.

Di seguito è illustrata una possibile struttura del ciclo per chiamare questa funzione.

do {
    bMore = WNDOBJ_bEnum(pwo, sizeof(buffer), &buffer.c);
    for (i = 0; i < buffer.c; i++) { 
        //  Process the data
    }
} while (bMore);

WNDOBJ_bEnum deve essere chiamato solo dalla funzione di callback fornita a GDI dalla funzione EngCreateWnd o dalle funzioni DDI grafiche a cui viene assegnato un WNDOBJ.

Requisiti

Vedi anche

EngCreateWnd

WNDOBJ

WNDOBJ_cEnumStart