Gestion des versions de la bibliothèque d’infrastructure

Dans cette rubrique, vous allez découvrir les conventions d’affectation de noms pour les noms de fichiers de la bibliothèque Kernel-Mode Driver Framework (KMDF) et de la bibliothèque UMDF (User-Mode Driver Framework).

KMDF

Un numéro de version principale et un numéro de version secondaire sont attribués à chaque version de la bibliothèque KMDF. Le nom de fichier de la bibliothèque contient le numéro de version principale. Le format du nom de fichier est le suivant :

Wdf<MajorVersionNumber>000.sys

Le numéro de version principale utilise deux caractères. Par exemple, le nom de fichier de la version 1.0 de la bibliothèque est Wdf01000.sys. Les versions 1.9, 1.11 et ainsi de suite sont également nommées Wdf01000.sys, et chaque nouvelle version mineure du fichier de bibliothèque remplace la version précédente du fichier.

Si vous avez créé votre pilote à l’aide d’une version de la bibliothèque KMDF plus récente que la version de l’infrastructure qui se trouve sur le système, cette dernière doit être mise à jour. Pour plus d’informations sur la mise à jour de la bibliothèque d’infrastructure, consultez Composants de l’infrastructure redistribuable.

(Notez que le nom de fichier du co-programme d’installation du framework inclut les numéros de version principale et secondaire. Pour plus d’informations sur les noms de fichiers de co-programme d’installation, consultez Utilisation du co-programme d’installation KMDF.)

Lorsque vous générez votre pilote, l’utilitaire MSBuild lie le pilote à un fichier stub qui contient le numéro de version de la bibliothèque utilisée par l’utilitaire MSBuild. Lorsque le système d’exploitation charge votre pilote, le chargeur de l’infrastructure vérifie les informations de version dans le stub de votre pilote pour déterminer si le pilote s’exécutera avec la version de la bibliothèque de framework qui se trouve sur le système.

Pour déterminer la version de la bibliothèque avec laquelle votre pilote s’exécute, le pilote peut appeler WdfDriverIsVersionAvailable ou WdfDriverRetrieveVersionString.

WDF vous permet de créer un pilote à l’aide d’une version de Windows différente de celle sur laquelle le pilote s’exécutera. Pour plus d’informations, consultez Génération d’un pilote WDF pour plusieurs versions de Windows.

Pour plus d’informations sur l’historique des versions de la bibliothèque KMDF, consultez Historique des versions KMDF.

UMDF

Comme avec KMDF, le numéro de version principal de la bibliothèque UMDF utilise deux caractères. Toutefois, le numéro de version principale apparaît uniquement dans le nom de fichier de la bibliothèque UMDF à partir de UMDF version 2.0.

Pour UMDF version 2.0, le nom de fichier de la bibliothèque UMDF est Wudfx02000.dll.

Pour UMDF version 1. x, le nom de fichier de la bibliothèque UMDF est Wudfx.dll.

Pour plus d’informations sur l’historique des versions de la bibliothèque KMDF, consultez Historique des versions UMDF.