WNDOBJ_bEnum-Funktion (winddi.h)
Die WNDOBJ_bEnum-Funktion ruft einen Batch von Rechtecken aus dem sichtbaren Bereich eines Fensters ab.
Syntax
ENGAPI BOOL WNDOBJ_bEnum(
WNDOBJ *pwo,
ULONG cj,
ULONG *pul
);
Parameter
pwo
Zeiger auf eine WNDOBJ-Struktur , die durch einen Aufruf von EngCreateWnd erstellt wurde.
cj
Gibt die Größe des Puffers in Bytes an, auf den pul verweist. GDI schreibt nicht über diesen Grenzwert hinaus.
pul
Zeiger auf den Puffer, in den eine Struktur der folgenden Form geschrieben werden soll. In dieser Struktur ist c eine Anzahl der zurückgegebenen Rechtecke, und arcl ist ein Array von Rechtecken:
typedef struct _ENUMRECTS{
ULONG c;
RECTL arcl[]
} ENUMRECTS;
Rückgabewert
Der Rückgabewert ist TRUE , wenn weitere Daten aufgelistet werden müssen und der Treiber den Aufruf wiederholen sollte. Er ist FALSE , wenn die Enumeration abgeschlossen ist.
Hinweise
Die Reihenfolge der Enumeration wird durch den Aufruf von WNDOBJ_cEnumStart bestimmt.
Es folgt eine mögliche Schleifenstruktur zum Aufrufen dieser Funktion.
do {
bMore = WNDOBJ_bEnum(pwo, sizeof(buffer), &buffer.c);
for (i = 0; i < buffer.c; i++) {
// Process the data
}
} while (bMore);
WNDOBJ_bEnum sollte nur durch die Rückruffunktion aufgerufen werden, die GDI von der EngCreateWnd-Funktion bereitgestellt wird, oder durch die Grafik-DDI-Funktionen, denen ein WNDOBJ zugewiesen wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Universell |
| Header | winddi.h (einschließlich Winddi.h) |
| Bibliothek | Win32k.lib |
| DLL | Win32k.sys |