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

Voir aussi

DRIVEROBJ

EngDeleteDriverObj