Présentation du fichier Sdv-map.h

Avant de vérifier un pilote, SDV analyse le code source du pilote et crée un fichier Sdv-map.h dans le répertoire des sources du pilote. Vous devez examiner et approuver ce fichier d’en-tête avant de vérifier votre pilote.

Vous pouvez également utiliser une commande staticdv /scan pour diriger SDV pour analyser le code du pilote et créer le fichier. Pour obtenir des instructions, consultez Analyse du pilote.

Si le fichier Sdv-map.h est incomplet ou incorrect, c’est-à-dire si l’un des points d’entrée est manquant ou si les points d’entrée sont associés au type de rôle de fonction incorrect, la vérification n’est pas fiable.

Pour obtenir la liste des fonctions utilisées par SDV pour les pilotes WDM, KMDF et NDIS, consultez Utilisation des déclarations de type de rôle de fonction.

Les types de rôles de fonction qui apparaissent dans le fichier Sdv-map.h sont ceux que SDV utilise dans sa vérification de règle. SDV utilise les déclarations de type de rôle de fonction que vous avez ajoutées à vos fichiers d’en-tête pour produire le fichier Sdv-map.h dans le répertoire de code source du pilote. Dans le fichier Sdv-map.h, SDV mappe les fonctions de pilote déclarées aux identificateurs de fonction utilisés par SDV pendant la vérification. Par exemple, pour un pilote KMDF, une fonction de rappel appelée MyDpc peut être mappée à fun_WDF_DPC_1.

SDV n’exige pas que le pilote déclare des types de rôle de fonction pour toutes les fonctions de rappel qu’il utilise. Cela nécessite uniquement que si le pilote a déclaré le type de rôle de fonction que SDV connaît et l’interprète correctement. Si un pilote n’a pas de type de rôle de fonction requis par SDV pour vérifier une règle particulière, SDV conclut que la règle ne s’applique pas au pilote. Il ne s’agit pas d’une erreur ou d’un défaut.

Il est important de corriger toutes les erreurs dans le fichier Sdv-map.h avant de vérifier le pilote. Si le fichier est incorrect, la vérification peut ne pas être fiable.