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

Weitere Informationen

DRIVEROBJ

EngDeleteDriverObj