Функция 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 |