Поделиться через

Функция EngCreateDriverObj (winddi.h)

  • Статья

Функция EngCreateDriverObj создает структуру DRIVEROBJ .

Синтаксис

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

Параметры

pvObj

Указатель на ресурс драйвера, который будет отслеживаться структурой DRIVEROBJ. Ресурс связан с текущим клиентским процессом.

pFreeObjProc

Указатель на функцию обратного вызова, предоставляемую драйвером, которая освобождает ресурс, на который указывает pvObj. Функция обратного вызова должна быть определена следующим образом, где pDriverObj указывает на структуру DRIVEROBJ:

BOOL CALLBACK DrvobjFreeObjProc(DRIVEROBJ *pDriverObj);

hdev

Дескриптор физического устройства, связанного с объектом . Этот параметр является дескриптором GDI, полученным функцией DrvCompletePDEV драйвера.

Возвращаемое значение

Возвращаемое значение — это дескриптор, который определяет только что созданную структуру DRIVEROBJ в случае успешного выполнения функции. В противном случае значение равно нулю.

Комментарии

Эта структура используется для отслеживания ресурса, управляемого устройством, который должен быть освобожден, если процесс выделения ресурсов завершается без предварительной очистки.

Драйвер может явно удалить структуру DRIVEROBJ, вызвав EngDeleteDriverObj. В противном случае подсистема освобождает ресурс, вызывая функцию, на которую указывает pFreeObjProc , когда процесс, создавший DRIVEROBJ, завершается.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Универсальное
Верхняя часть winddi.h (включая Winddi.h)
Библиотека Win32k.lib
DLL Win32k.sys

См. также раздел

DRIVEROBJ

EngDeleteDriverObj