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

Confira também

DRIVEROBJ

EngDeleteDriverObj