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
與對象相關聯的實體裝置句柄。 此參數是驅動程式 DrvCompletePDEV 函式收到的 GDI 句柄。
傳回值
如果函式成功，傳回值是識別新建立 DRIVEROBJ 結構的句柄。 否則為零。
備註
此結構用來追蹤裝置管理的資源，如果資源配置進程終止而不需要先加以清除，就必須釋放該資源。
驅動程式可以藉由呼叫 EngDeleteDriverObj 來明確刪除 DRIVEROBJ 結構。 否則，當建立 DRIVEROBJ 的程式終止時，引擎會呼叫 pFreeObjProc 所指向的函式來釋放資源。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows 作業系統。 |
| 目標平台 | Universal |
| 標頭 | winddi.h (包含Winddi.h) |
| 程式庫 | Win32k.lib |
| Dll | Win32k.sys |