Création d’un pilote logiciel
Dans cette rubrique, nous expliquons comment utiliser Visual Studio pour commencer à écrire un nouveau pilote logiciel. Les pilotes logiciels sont différents des pilotes de fonction de périphérique, des pilotes de filtre et des pilotes de système de fichiers, que nous abordons dans d’autres rubriques. Pour plus d’informations sur les pilotes logiciels et la façon dont ils diffèrent des autres types de pilotes, consultez Qu’est-ce qu’un pilote ? et Choix d’un modèle de pilote.
Pour commencer, commencez par déterminer le modèle de pilote approprié pour votre pilote logiciel. Les trois options sont l’infrastructure kmdf (Kernel Mode Driver Framework), le modèle de pilote NT hérité et le modèle de pilote Windows (WDM). Pour obtenir de l’aide sur le modèle qui vous convient le mieux, consultez Choisir un modèle de pilote.
Cas 1 : Vous souhaitez utiliser KMDF
- Dans Visual Studio, dans le menu Fichier , choisissez Nouveau | Projet.
- Dans la boîte de dialogue Nouveau projet, dans le volet gauche, recherchez et sélectionnez WDF.
- Dans le volet central, sélectionnez Pilote en mode noyau (KMDF).
- Renseignez les zones Nom et Emplacement , puis sélectionnez OK. Pour plus d’informations, consultez Écriture d’un pilote KMDF basé sur un modèle.
Notes
Lorsque vous créez un pilote KMDF, vous devez sélectionner un nom de pilote comportant 32 caractères ou moins. Cette limite de longueur est définie dans wdfglobals.h.
- À ce stade, vous avez un projet de pilote qui implémente le code général requis par la plupart des pilotes KMDF. Vous pouvez maintenant fournir le code spécifique à votre pilote logiciel.
Cas 2 : Vous souhaitez utiliser le modèle NT hérité
Dans Visual Studio, dans le menu Fichier , choisissez Nouveau | Projet.
Dans Visual Studio, dans la boîte de dialogue Nouveau projet, sous Pilote Windows, sélectionnez WDM | Pilote WDM vide.
Notes
Vous n’allez pas écrire de pilote WDM, mais vous avez besoin du modèle Pilote WDM vide .
Renseignez les zones Nom et Emplacement , puis sélectionnez OK.
À ce stade, vous avez un projet de pilote WDM vide. Dans la fenêtre de Explorateur de solutions, sélectionnez et maintenez votre projet de pilote enfoncé (ou cliquez avec le bouton droit), puis choisissez Ajouter | Nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez Fichier C++ (.cpp), entrez un nom pour votre fichier, puis sélectionnez OK.
Notes
Si vous souhaitez créer un fichier .c au lieu d’un fichier .cpp, entrez un nom qui a l’extension .c .
Incluez ntddk.h.
Implémentez les fonctions requises par votre pilote logiciel. Lorsque vous implémentez et organisez vos fonctions, vous pouvez décider d’ajouter des fichiers d’en-tête et des fichiers .cpp ou .c supplémentaires.
Cas 3 : Vous souhaitez utiliser WDM
Il est très peu probable que vous souhaitiez utiliser WDM pour un pilote logiciel. Mais si c’est le cas, suivez ces étapes.
Dans Visual Studio, dans le menu Fichier , choisissez Nouveau | Projet.
Dans Visual Studio, dans la boîte de dialogue Nouveau projet, sous Pilote Windows, sélectionnez WDM.
Renseignez les zones Nom et Emplacement , puis sélectionnez OK.
À ce stade, vous avez un projet de pilote WDM vide. Dans la fenêtre de Explorateur de solutions, sélectionnez et maintenez votre projet de pilote enfoncé (ou cliquez avec le bouton droit), puis choisissez Ajouter | Nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez Fichier C++ (.cpp), entrez un nom pour votre fichier, puis sélectionnez OK.
Notes
Si vous souhaitez créer un fichier .c au lieu d’un fichier .cpp, entrez un nom qui a l’extension .c .
Incluez wdm.h.
Implémentez les fonctions requises par votre pilote logiciel. Lorsque vous implémentez et organisez vos fonctions, vous pouvez décider d’ajouter des fichiers d’en-tête et des fichiers .cpp ou .c supplémentaires.