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 |