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

Weitere Informationen

EngCreateWnd

WNDOBJ

WNDOBJ_cEnumStart