Fonction DrvEnableDriver (winddi.h)

Article
08/27/2023

La fonction DrvEnableDriver est le point d’entrée initial du pilote exporté par la DLL du pilote. Il remplit une structure DRVENABLEDATA avec le numéro de version DDI graphique du pilote et les adresses d’appel de toutes les fonctions DDI graphiques prises en charge par le pilote.

Syntaxe

BOOL DrvEnableDriver(
       ULONG         iEngineVersion,
       ULONG         cj,
  [in] DRVENABLEDATA *pded
);

Paramètres

iEngineVersion

Identifie la version de GDI en cours d’exécution.

cj

Taille en octets de la structure pointée vers pded. Si la structure est plus grande que prévu, les membres supplémentaires ne doivent pas être modifiés.

[in] pded

Pointeur vers une structure DRVENABLEDATA . GDI initialise zéro octets cj avant l’appel. Le pilote remplit ses propres données.

Valeur retournée

La valeur de retour est TRUE si le pilote spécifié est activé. Sinon, il est FALSE et un code d’erreur est journalisé.

Remarques

DrvEnableDriver doit être implémenté dans tous les pilotes graphiques. Si vous utilisez les outils de génération du Kit de pilotes Windows (WDK) et que vous avez défini TARGETTYPE sur GDI_DRIVER (voir Création d’une DLL de graphiques d’imprimante), cette fonction doit être nommée DrvEnableDriver. Il s’agit de la seule fonction de pilote d’affichage qui doit être accessible par nom. Toutes les autres fonctions de pilote d’affichage sont accessibles via des pointeurs de fonction ; par conséquent, leurs noms sont présentés dans cette documentation sous forme de pseudonoms.

Des initialisations ponctuelles, telles que l’allocation de sémaphores, peuvent également être effectuées par cette fonction. Le pilote doit attendre que DrvEnablePDEV soit appelé avant d’activer le matériel, tel qu’un affichage.

Lors de la vérification de version à l’aide de la valeur fournie dans iEngineVersion, le pilote doit utiliser la constante DDI_DRIVER_VERSION_Xxx appropriée (définie dans winddi.h) indiquée dans le tableau suivant. Les pilotes ne devraient presque jamais case activée uniquement pour l’égalité, car les nouvelles versions et les versions du Service Pack pour le système d’exploitation seront publiées à l’avenir. Pour plus d’informations, consultez DRVENABLEDATA.

Valeur	Version du système d'exploitation
DDI_DRIVER_VERSION_NT4	Windows NT 4.0
DDI_DRIVER_VERSION_SP3	Windows NT 4.0 Service Pack 3
DDI_DRIVER_VERSION_NT5	Windows 2000
DDI_DRIVER_VERSION_NT5_01	Windows XP
DDI_DRIVER_VERSION_NT5_01_SP1	Windows XP Service Pack 1