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
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |