Composants d’infrastructure redistribuables

  • Article

Remarque

Si votre pilote cible uniquement Windows 10 ou version ultérieure, vous n’avez pas besoin de redistribuer WDF ou de fournir un coinstallateur dans votre package de pilotes. Procédez comme suit :

  1. Dans Visual Studio, dans la page de propriétés Paramètres du projet, sous Paramètres du pilote ->Version du système d’exploitation cible, sélectionnez Windows 10 ou version ultérieure. Cela équivaut à ajouter les éléments suivants au fichier .vcxproj :
<PropertyGroup Label="Configuration">
<TargetVersion>Windows10</TargetVersion>
  1. Dans la section Fabricant INF, spécifiez la version 10.0 du système d’exploitation cible, comme suit :
[Manufacturer]
%MyMfg% = MyMfg, NTamd64.10.0

Cette rubrique décrit les mises à jour de framework redistribuable fournies par Microsoft qui sont incluses dans le kit de pilotes Windows (WDK) et comment déterminer celles à ajouter à votre package de pilotes.

Les mises à jour du framework redistribuable permettent d’exécuter un pilote généré avec une version ultérieure de l’infrastructure que celle incluse dans un système d’exploitation. Par exemple, KMDF 1.11 est inclus dans Windows 8. Toutefois, vous pouvez exécuter un pilote KMDF 1.11 sur Windows Vista ou Windows 7. Avant de pouvoir le faire, toutefois, vous devez vous assurer que la bibliothèque d’infrastructure KMDF 1.11 remplace la bibliothèque d’infrastructure incluse dans le système d’exploitation précédent (dans ce cas, KMDF 1.7 et KMDF 1.9 respectivement). Pour ce faire, redistribuez un fichier de co-programme d’installation ou .msu fourni par Microsoft avec votre package de pilotes.

Quand dois-je inclure un co-programme d’installation ou .msu dans mon package de pilotes ?

Tout d’abord, déterminez les versions de Windows que votre pilote prendra en charge. En fonction de cela, déterminez la version de l’infrastructure à utiliser.

Si la version WDF choisie est plus récente que la version fournie avec le système d’exploitation cible, incluez le fichier co-programme d’installation ou .msu dans votre package de pilotes.

Par exemple, vous souhaitez que votre pilote s’exécute sur Windows 7. Vous pouvez choisir de générer votre pilote à l’aide de WDF 1.11 ou WDF 1.9. Si vous choisissez la version 1.9, qui est fournie avec Windows 7, il n’est pas nécessaire de mettre à jour le système. En revanche, si vous choisissez la version 1.11, vous devez inclure un package de mise à jour WDF 1.11 avec votre pilote.

Dois-je inclure le co-programme d’installation ou le fichier .msu ?

Si l’installation de votre pilote est déclenchée en connectant un nouveau périphérique matériel à un système et que vous installez uniquement le pilote, incluez le co-programme d’installation dans votre package de pilotes. Référencez ensuite le co-programme d’installation dans votre fichier INF, comme décrit dans Spécifier le co-programme d’installation KMDF dans un fichier INF.

Si vous devez installer une application en plus de votre pilote, vous devez redistribuer plutôt le package MSU approprié (par exemple kmdf-1.11-Win.6.0.msu) ainsi qu’une application d’installation qui l’appelle. Dans ce cas, aucune entrée INF n’est nécessaire.

Vous n’avez jamais besoin du co-programme d’installation et du fichier .msu.

Où puis-je trouver ces fichiers et ce qui est inclus ?

Ces fichiers ne sont plus inclus dans le WDK. Au lieu de cela, ils sont disponibles sous forme de téléchargement distinct à partir du Centre de téléchargement Microsoft. La page de téléchargement est les composants redistribuables du Kit de pilotes Windows 8.

Après l’installation, les msu et les co-programmes d’installation se trouvent sous %program files%\Windows Kits\8.0\redist\wdf.

Ce répertoire contient les fichiers suivants, pour x86 et x64 :

  • WdfCoinstaller01007.dll, WdfCoinstaller01009.dll, WdfCoinstaller01011.dll (co-programmes d’installation pour KMDF 1.7/1.9/1.11).
  • WUDFUpdate_01007.dll, WUDFUpdate_01009.dll, WUDFUpdate_01011.dll (co-programmes d’installation pour UMDF).
  • winusbcoinstaller.dll, winusbcoinstaller2.dll (co-programmes d’installation pour WinUSB 1.5/1.9).

Attribution de noms et de versions de co-programme d’installation

Le co-programme d’installation est nommé WdfCoInstallerMMmmm.dll.

  • MM est le numéro de version principale.
  • mmm est le numéro de version mineure.

Par exemple, le nom de fichier de la version 1.0 du co-programme d’installation est WdfCoInstaller01000.dll, et le nom de fichier de la version 1.11 est WdfCoInstaller01011.dll.

La version du co-programme d’installation que vous incluez avec votre package de pilotes doit correspondre à la version de la bibliothèque d’infrastructure que vous utilisez pour développer votre pilote.

Notez que le nom de fichier de la bibliothèque d’infrastructure inclut uniquement le numéro de version principale. Pour plus d’informations sur les noms de fichiers de bibliothèque, consultez Gestion des versions de la bibliothèque Framework.