Função EngCreateDriverObj (winddi.h)
A função EngCreateDriverObj cria uma estrutura DRIVEROBJ .
Sintaxe
ENGAPI HDRVOBJ EngCreateDriverObj(
PVOID pvObj,
FREEOBJPROC pFreeObjProc,
HDEV hdev
);
Parâmetros
pvObj
Ponteiro para o recurso de driver que será rastreado pela estrutura DRIVEROBJ. O recurso está associado ao processo do cliente atual.
pFreeObjProc
Ponteiro para uma função de retorno de chamada fornecida pelo driver que libera o recurso apontado por pvObj. A função de retorno de chamada deve ser definida da seguinte maneira, em que pDriverObj aponta para a estrutura DRIVEROBJ:
BOOL CALLBACK DrvobjFreeObjProc(DRIVEROBJ *pDriverObj);
hdev
Manipule para o dispositivo físico associado ao objeto . Esse parâmetro é o identificador GDI recebido pela função DrvCompletePDEV do driver.
Retornar valor
O valor retornado é um identificador que identifica a estrutura DRIVEROBJ recém-criada se a função for bem-sucedida. Caso contrário, será zero.
Comentários
Essa estrutura é usada para rastrear um recurso gerenciado pelo dispositivo que deve ser liberado se o processo de alocação de recursos for encerrado sem primeiro limpá-lo.
O driver pode excluir explicitamente a estrutura DRIVEROBJ chamando EngDeleteDriverObj. Caso contrário, o mecanismo libera o recurso chamando a função apontada por pFreeObjProc quando o processo que criou o DRIVEROBJ é encerrado.
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 |