Share via


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

Vedi anche

PATHOBJ

PATHOBJ_bEnumClipLines