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 |