WNDOBJ_cEnumStart-Funktion (winddi.h)

Artikel
08/27/2023

Die WNDOBJ_cEnumStart-Funktion ist eine Rückruffunktion, die Parameter für die Enumeration von Rechtecke im sichtbaren Bereich eines Fensters festlegt.

Syntax

ENGAPI ULONG WNDOBJ_cEnumStart(
  WNDOBJ *pwo,
  ULONG  iType,
  ULONG  iDirection,
  ULONG  cLimit
);

Parameter

pwo

Zeiger auf eine WNDOBJ-Struktur , die durch einen Aufruf von EngCreateWnd erstellt wurde.

iType

Gibt den Typ der Strukturen an, die von WNDOBJ_bEnum zurückgegeben werden sollen. Dieser Parameter kann CT_RECTANGLES werden, was bedeutet, dass die Region als Liste von Rechtecken aufgezählt werden soll.

iDirection

Bestimmt die Reihenfolge, in der die Rechtecke zurückgegeben werden. Diese Reihenfolge kann wichtig sein, wenn ein überlappender DrvBitBlt auf derselben Oberfläche ausgeführt wird. Wenn die Bestellung für den Gerätetreiber nicht relevant ist, sollte CD_ANY angegeben werden. Dadurch kann GDI seine Enumeration für komplexe Regionen optimieren. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
CD_ANY	Jeder Auftrag, der für GDI geeignet ist.
CD_LEFTDOWN	Von rechts nach links, von oben nach unten.
CD_LEFTUP	Rechts nach links, unten nach oben.
CD_LEFTWARDS	Von links nach rechts ist die vertikale Richtung nicht definiert.
CD_RIGHTDOWN	Von links nach rechts, von oben nach unten.
CD_RIGHTUP	Von links nach rechts, unten nach oben.
CD_UPWARDS	Von unten nach oben ist die horizontale Richtung nicht definiert.

cLimit

Gibt an, wie viele Objekte der Treiber an der Zwischenspeicherung interessiert ist. Dies wird nur verwendet, um zu entscheiden, wann das Zählen von Rechtecke beendet werden soll, während GDI den Rückgabewert für diese Funktion berechnet. Wenn cLimit null ist, wird nicht gezählt.

Rückgabewert

Der Rückgabewert ist eine Anzahl der Objekte, die aufgelistet werden, vorausgesetzt, dieser Wert ist kleiner oder gleich cLimit. Wenn die Anzahl größer als cLimit ist, wird der Rückgabewert 0xFFFFFFFF.

Hinweise

Die Enumeration kann neu gestartet werden, indem Sie diese Funktion erneut aufrufen.

WNDOBJ_cEnumStart sollte nur aufgerufen werden:

Im Kontext der Treiberrückruffunktion, die für GDI in der EngCreateWnd-Funktion bereitgestellt wird, oder der Grafik-DDI-Funktionen, bei denen ein WNDOBJ angegeben ist.
Wenn der aufrufende Thread über die Gerätesperre verfügt, um sicherzustellen, dass keine Änderungen an der Clientregion auftreten.

Anforderungen

Anforderung	Wert
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