EngCreatePath-Funktion (winddi.h)

Die EngCreatePath-Funktion weist einen Pfad für die temporäre Verwendung des Treibers zu.

Syntax

ENGAPI PATHOBJ * EngCreatePath();

Rückgabewert

Der Rückgabewert ist ein Zeiger auf eine PATHOBJ-Struktur , wenn die Funktion erfolgreich ist. Andernfalls ist er NULL, und ein Fehlercode wird protokolliert.

Hinweise

Der Treiber sollte den von EngCreatePath zugeordneten Pfad löschen, bevor er aus dem aktuellen Zeichnungsaufruf zu GDI zurückkehrt.

Funktionen, die Pfade erstellen und ändern, werden bereitgestellt, um Geräte beim Beschneiden von Pfaden zu unterstützen. Ein Treiber kann einen Pfad erstellen, ihn mit Zeilen füllen und den Pfad an PATHOBJ_bEnumClipLines übergeben, um den komplexen Bereich abzuschneiden.

Eine PATHOBJ-Struktur ist ein gesperrtes Objekt und sollte daher nicht lange vom Treiber gesperrt werden.

Wenn der Treiber EngCreatePath zum Erstellen einer PATHOBJ-Struktur verwendet, sollte sie mithilfe von EngDeletePath gelöscht werden, sobald der Treiber damit fertig ist.

Die zurückgegebene PATHOBJ-Struktur wird in Aufrufen von PATHOBJ_bMoveTo, PATHOBJ_bPolyLineTo, PATHOBJ_vEnumStartClipLines und PATHOBJ_bEnumClipLines

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

Weitere Informationen

PATHOBJ

PATHOBJ_bEnumClipLines