EngCreateDriverObj-Funktion (winddi.h)
Die EngCreateDriverObj-Funktion erstellt eine DRIVEROBJ-Struktur .
Syntax
ENGAPI HDRVOBJ EngCreateDriverObj(
PVOID pvObj,
FREEOBJPROC pFreeObjProc,
HDEV hdev
);
Parameter
pvObj
Zeiger auf die Treiberressource, die von der DRIVEROBJ-Struktur nachverfolgt wird. Die Ressource ist dem aktuellen Clientprozess zugeordnet.
pFreeObjProc
Zeiger auf eine vom Treiber bereitgestellte Rückruffunktion, die die Ressource freigibt, auf die von pvObj verwiesen wird. Die Rückruffunktion sollte wie folgt definiert werden, wobei pDriverObj auf die DRIVEROBJ-Struktur verweist:
BOOL CALLBACK DrvobjFreeObjProc(DRIVEROBJ *pDriverObj);
hdev
Handle mit dem physischen Gerät, das dem Objekt zugeordnet ist. Dieser Parameter ist das GDI-Handle, das von der DrvCompletePDEV-Funktion des Treibers empfangen wird.
Rückgabewert
Der Rückgabewert ist ein Handle, das die neu erstellte DRIVEROBJ-Struktur identifiziert, wenn die Funktion erfolgreich ist. Andernfalls ist es 0.
Hinweise
Diese Struktur wird verwendet, um eine geräteverwaltete Ressource nachzuverfolgen, die freigegeben werden muss, wenn der Prozess zur Ressourcenzuordnung beendet wird, ohne sie zuvor zu bereinigen.
Der Treiber kann die DRIVEROBJ-Struktur explizit löschen, indem er EngDeleteDriverObj aufruft. Andernfalls gibt das Modul die Ressource frei, indem die Funktion aufgerufen wird, auf die pFreeObjProc verweist, wenn der Prozess, der den DRIVEROBJ erstellt hat, beendet wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Universell |
| Header | winddi.h (einschließlich Winddi.h) |
| Bibliothek | Win32k.lib |
| DLL | Win32k.sys |