WNDOBJ_cEnumStart-Funktion (winddi.h)
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 |