Fonction EngCreateDriverObj (winddi.h)
La fonction EngCreateDriverObj crée une structure DRIVEROBJ .
Syntaxe
ENGAPI HDRVOBJ EngCreateDriverObj(
PVOID pvObj,
FREEOBJPROC pFreeObjProc,
HDEV hdev
);
Paramètres
pvObj
Pointeur vers la ressource de pilote qui sera suivie par la structure DRIVEROBJ. La ressource est associée au processus client actuel.
pFreeObjProc
Pointeur vers une fonction de rappel fournie par le pilote qui libère la ressource pointée par pvObj. La fonction de rappel doit être définie comme suit, où pDriverObj pointe vers la structure DRIVEROBJ :
BOOL CALLBACK DrvobjFreeObjProc(DRIVEROBJ *pDriverObj);
hdev
Gérez l’appareil physique associé à l’objet. Ce paramètre est le handle GDI reçu par la fonction DrvCompletePDEV du pilote.
Valeur retournée
La valeur de retour est un handle qui identifie la structure DRIVEROBJ nouvellement créée si la fonction réussit. Sinon, c’est zéro.
Remarques
Cette structure permet de suivre une ressource gérée par l’appareil qui doit être libérée si le processus d’allocation des ressources se termine sans le nettoyer au préalable.
Le pilote peut supprimer explicitement la structure DRIVEROBJ en appelant EngDeleteDriverObj. Sinon, le moteur libère la ressource en appelant la fonction pointée par pFreeObjProc lorsque le processus qui a créé le DRIVEROBJ se termine.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | winddi.h (inclure Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |