Função EngCreatePath (winddi.h)
A função EngCreatePath aloca um caminho para o uso temporário do driver.
Sintaxe
ENGAPI PATHOBJ * EngCreatePath();
Retornar valor
O valor retornado será um ponteiro para uma estrutura PATHOBJ se a função for bem-sucedida. Caso contrário, ele será nulo e um código de erro será registrado.
Comentários
O driver deve excluir o caminho, alocado por EngCreatePath, antes de retornar à GDI de sua chamada de desenho atual.
As funções que criam e modificam caminhos são fornecidas para auxiliar dispositivos em caminhos de recorte. Um driver pode criar um caminho, preenchê-lo com linhas e passar o caminho para PATHOBJ_bEnumClipLines para recorte na região complexa.
Uma estrutura PATHOBJ é um objeto bloqueado e, portanto, não deve ser bloqueada por muito tempo pelo driver.
Se o driver usar EngCreatePath para criar uma estrutura PATHOBJ, ele deverá ser excluído usando EngDeletePath assim que o driver terminar com ela.
A estrutura PATHOBJ retornada é usada em chamadas para PATHOBJ_bMoveTo, PATHOBJ_bPolyLineTo, PATHOBJ_vEnumStartClipLines e PATHOBJ_bEnumClipLines
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | winddi.h (inclua Winddi.h) |
| Biblioteca | Win32k.lib |
| DLL | Win32k.sys |