Función EngCreateDriverObj (winddi.h)

La función EngCreateDriverObj crea una estructura DRIVEROBJ .

Sintaxis

ENGAPI HDRVOBJ EngCreateDriverObj(
  PVOID       pvObj,
  FREEOBJPROC pFreeObjProc,
  HDEV        hdev
);

Parámetros

pvObj

Puntero al recurso de controlador al que realizará el seguimiento la estructura DRIVEROBJ. El recurso está asociado al proceso de cliente actual.

pFreeObjProc

Puntero a una función de devolución de llamada proporcionada por el controlador que libera el recurso al que apunta pvObj. La función de devolución de llamada debe definirse de la siguiente manera, donde pDriverObj apunta a la estructura DRIVEROBJ:

BOOL CALLBACK DrvobjFreeObjProc(DRIVEROBJ *pDriverObj);

hdev

Identificador del dispositivo físico asociado al objeto . Este parámetro es el identificador GDI recibido por la función DrvCompletePDEV del controlador.

Valor devuelto

El valor devuelto es un identificador que identifica la estructura DRIVEROBJ recién creada si la función es correcta. De lo contrario, es cero.

Comentarios

Esta estructura se usa para realizar un seguimiento de un recurso administrado por el dispositivo que se debe liberar si el proceso de asignación de recursos finaliza sin limpiarlo primero.

El controlador puede eliminar explícitamente la estructura DRIVEROBJ llamando a EngDeleteDriverObj. De lo contrario, el motor libera el recurso llamando a la función a la que apunta pFreeObjProc cuando finaliza el proceso que creó driverOBJ.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Universal
Encabezado	winddi.h (incluya Winddi.h)
Library	Win32k.lib
Archivo DLL	Win32k.sys

Consulte también

DRIVEROBJ

EngDeleteDriverObj