Funzione EngCreatePath (winddi.h)
La funzione EngCreatePath alloca un percorso per l'uso temporaneo del driver.
Sintassi
ENGAPI PATHOBJ * EngCreatePath();
Valore restituito
Il valore restituito è un puntatore a una struttura PATHOBJ se la funzione ha esito positivo. In caso contrario, è Null e viene registrato un codice di errore.
Commenti
Il driver deve eliminare il percorso, allocato da EngCreatePath, prima di tornare a GDI dalla chiamata di disegno corrente.
Le funzioni che creano e modificano i percorsi vengono fornite per facilitare i dispositivi nei percorsi di ritaglio. Un driver può creare un percorso, riempirlo con linee e passare il percorso a PATHOBJ_bEnumClipLines per ritagliare l'area complessa.
Una struttura PATHOBJ è un oggetto bloccato e pertanto non deve essere bloccata per molto tempo dal driver.
Se il driver usa EngCreatePath per creare una struttura PATHOBJ, deve essere eliminata usando EngDeletePath non appena il driver termina con esso.
La struttura PATHOBJ restituita viene usata nelle chiamate a PATHOBJ_bMoveTo, PATHOBJ_bPolyLineTo, PATHOBJ_vEnumStartClipLines e PATHOBJ_bEnumClipLines
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |