Fungsi EngCreateDriverObj (winddi.h)
Fungsi EngCreateDriverObj membuat struktur DRIVEROBJ .
Sintaks
ENGAPI HDRVOBJ EngCreateDriverObj(
PVOID pvObj,
FREEOBJPROC pFreeObjProc,
HDEV hdev
);
Parameter
pvObj
Arahkan ke sumber daya driver yang akan dilacak oleh struktur DRIVEROBJ. Sumber daya dikaitkan dengan proses klien saat ini.
pFreeObjProc
Penunjuk ke fungsi panggilan balik yang disediakan driver yang membebaskan sumber daya yang ditujukkan oleh pvObj. Fungsi panggilan balik harus didefinisikan sebagai berikut, di mana pDriverObj menunjuk ke struktur DRIVEROBJ:
BOOL CALLBACK DrvobjFreeObjProc(DRIVEROBJ *pDriverObj);
hdev
Tangani ke perangkat fisik yang terkait dengan objek . Parameter ini adalah handel GDI yang diterima oleh fungsi DrvCompletePDEV driver.
Nilai kembali
Nilai yang dikembalikan adalah handel yang mengidentifikasi struktur DRIVEROBJ yang baru dibuat jika fungsi berhasil. Jika tidak, itu nol.
Keterangan
Struktur ini digunakan untuk melacak sumber daya yang dikelola perangkat yang harus dirilis jika proses alokasi sumber daya berakhir tanpa terlebih dahulu membersihkannya.
Driver dapat secara eksplisit menghapus struktur DRIVEROBJ dengan memanggil EngDeleteDriverObj. Jika tidak, mesin membebaskan sumber daya dengan memanggil fungsi yang ditunjukkan oleh pFreeObjProc ketika proses yang membuat DRIVEROBJ berakhir.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows. |
Target Platform | Universal |
Header | winddi.h (termasuk Winddi.h) |
Pustaka | Win32k.lib |
DLL | Win32k.sys |