Share via

Componenti ridistribuibili del framework

  • Articolo

Nota

Se il driver è destinato solo Windows 10, non è necessario ridistribuire WDF o fornire un Coinstaller nel pacchetto driver. Per specificare come destinazione Windows 10:

  1. In Visual Studio, nella pagina delle proprietà Impostazioni progetto, in Impostazioni driver ->Versione del sistema operativo di destinazione selezionare Windows 10 o versione successiva. Equivale ad aggiungere quanto segue al file con estensione vcxproj:
<PropertyGroup Label="Configuration">
<TargetVersion>Windows10</TargetVersion>
  1. Nella sezione Produttore INF specificare 10.0 come versione del sistema operativo di destinazione, come indicato di seguito:
[Manufacturer]
%MyMfg% = MyMfg, NTamd64.10.0

Questo argomento descrive gli aggiornamenti ridistribuibili forniti da Microsoft inclusi come parte di Windows Driver Kit (WDK) e come determinare quali aggiungere al pacchetto driver.

Gli aggiornamenti del framework ridistribuibile consentono di eseguire un driver compilato con una versione del framework successiva rispetto a quella inclusa in un sistema operativo. Ad esempio, KMDF 1.11 è incluso in Windows 8. È tuttavia possibile eseguire un driver KMDF 1.11 in Windows Vista o Windows 7. Prima di eseguire questa operazione, tuttavia, è necessario assicurarsi che la libreria di framework KMDF 1.11 sostituisca la libreria framework inclusa nel sistema operativo precedente (in questo caso, KMDF 1.7 e KMDF 1.9). A tale scopo, ridistribuire un co-installer fornito da Microsoft o un file con estensione msu con il pacchetto driver.

Quando è necessario includere un co-programma di installazione o un file con estensione msu nel pacchetto driver?

In primo luogo, decidere quali versioni di Windows supporteranno il driver. In base a questo, determinare la versione del framework da usare.

Se la versione WDF scelta è più recente della versione fornita con il sistema operativo di destinazione, includere il co-installer o il file con estensione msu nel pacchetto driver.

Ad esempio, si vuole che il driver sia eseguito in Windows 7. È possibile scegliere di compilare il driver usando WDF 1.11 o WDF 1.9. Se si sceglie la versione 1.9, fornita con Windows 7, non è necessario aggiornare il sistema. D'altra parte, se si sceglie 1.11, è necessario includere un pacchetto di aggiornamento WDF 1.11 con il driver.

È necessario includere il co-programma di installazione o il file con estensione msu?

Se l'installazione del driver viene attivata collegando un nuovo dispositivo hardware a un sistema e si installa solo il driver, includere il co-programma di installazione nel pacchetto driver. Fare quindi riferimento al co-programma di installazione nel file INF, come descritto in Specifica del co-programma di installazione KMDF in un file INF.

Se devi installare un'applicazione oltre al driver, devi invece ridistribuire il pacchetto MSU pertinente (ad esempio kmdf-1.11-Win.6.0.msu) insieme a un'applicazione di installazione che lo chiama. In questo caso, non sono necessarie voci INF.

Non è mai necessario il co-programma di installazione e il file msu.

Dove posso trovare questi file e cosa è incluso?

I co-programmi di installazione si trovano in %program files%\Windows Kits\<version>\redist\wdf.

Questa directory contiene i file seguenti, per x86 e x64:

  • WdfCoinstaller01007.dll, WdfCoinstaller01009.dll, WdfCoinstaller01011.dll (co-installer per KMDF 1.7/1.9/1.11).
  • WUDFUpdate_01007.dll, WUDFUpdate_01009.dll, WUDFUpdate_01011.dll (co-installer per UMDF).
  • winusbcoinstaller.dll, winusbcoinstaller2.dll (co-installer per WinUSB 1.5/1.9).

Se si desidera il file MSU, scaricare e installare il pacchetto (in formato MSI) dai componenti ridistribuibili di WDK 8. Dopo l'installazione, gli MSU e i coinstallazioni sono disponibili in %program files%\Windows Kits\8.0\redist\wdf.

Denominazione e controllo delle versioni del co-programma di installazione

Il co-programma di installazione è denominato WdfCoInstallerMMmmm.dll.

  • MM è il numero di versione principale.
  • mmm è il numero di versione secondaria.

Ad esempio, il nome file per la versione 1.0 del co-programma di installazione è WdfCoInstaller01000.dlle il nome file per la versione 1.11 è WdfCoInstaller01011.dll.

La versione del programma di installazione condivisa inclusa nel pacchetto driver deve corrispondere alla versione della libreria framework usata per sviluppare il driver.

Si noti che il nome file della libreria framework include solo il numero di versione principale. Per altre informazioni sui nomi dei file di libreria, vedere Controllo delle versioni della libreria framework.