Condividi tramite

Uso del co-programma di installazione di UMDF

  • Articolo

Nota

Se il driver è destinato solo Windows 10, non è necessario ridistribuire WDF o fornire un coinstaller nel pacchetto driver. Per 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 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

Potrebbe comunque essere necessario fare riferimento al coinstallatore fornito dal sistema come indicato di seguito:

[Echo_Install.NT.CoInstallers] 
AddReg=CoInstallers_AddReg

[CoInstaller.AddReg]
HKR,,CoInstallers32,0x00010000,WudfCoinstaller.dll

Un co-programma di installazione aggiorna la versione del framework archiviata nelle sezioni file INF specifiche del computer e elabora il framework. In questo argomento vengono descritti i due co-installer UMDF e quando è necessario includere uno con il pacchetto di installazione del driver o fare riferimento a un co-installer nel file INF.

Recupero del pacchetto co-installer

In Windows 8.1 gli aggiornamenti del framework ridistribuibile forniti da Microsoft sono inclusi come parte di Windows Driver Kit (WDK).

Per un elenco completo del contenuto della directory co-installer, vedere Componenti di installazione per i driver KMDF.

Tra gli altri componenti, la directory co-installer contiene un co-installer di aggiornamento, denominato WUDFUpdate_MMmmm.dll, dove MM è il numero di versione principale e mmm è il numero di versione secondario.

Il co-programma di installazione dell'aggiornamento aggiorna la versione del framework UMDF che si trova nel computer. Ad esempio, se il computer ha UMDF versione 1.9 e il co-installer contiene la versione 1.11, il co-installer aggiorna la versione del framework del computer alla versione 1.11.

Il sistema operativo include un altro co-installer, denominato co-installer di configurazione o WudfCoinstaller.dll. Il co-programma di installazione della configurazione elabora le sezioni specifiche di UMDF del file INF del driver e apporta eventuali aggiornamenti necessari al Registro di sistema.

Riferimento ai co-installer dal file INF

Se si scrive un driver UMDF 2.0 per Windows 8.1, il file INF deve fare riferimento al co-installer di configurazione. Poiché il co-installer di configurazione è incluso nel sistema operativo, non è necessario ridistribuirlo.

Se si scrive un driver UMDF 1.11 destinato ai sistemi operativi prima di Windows 8.1, è necessario assicurarsi che la versione 1.11 del framework sia installata nei computer che usano il driver. Ecco tre modi per eseguire questa operazione:

  • Fare riferimento al co-installer di aggiornamento nel file INF e includere il co-installer di aggiornamento nel pacchetto di installazione del driver. Quando il sistema operativo installa il driver, esegue il co-installer. Se il driver verrà distribuito tramite Windows Update, è necessario scegliere questa opzione.

  • Ridistribuire il pacchetto MSU pertinente (ad esempio umdf-1.11-Win-6.0.msu) insieme a un'applicazione di installazione che lo chiama. È possibile trovare un esempio di tale applicazione nella sottodirectory src\general\wdkinstall dell'installazione WDK. È possibile scegliere questa opzione se si sta scrivendo un programma di installazione fornito con il dispositivo e deve essere eseguito prima che il dispositivo possa essere usato. Se si sceglie questa opzione, il file INF deve fare riferimento al co-installer di configurazione.

  • Si basano su Windows Update per installare la versione del framework necessaria nei computer che usano il driver. A partire dalla versione 1.11 del framework, le nuove versioni di UMDF vengono distribuite tramite Windows Update. Se si sceglie questa opzione, il file INF deve fare riferimento al co-installer di configurazione.

Nel file INF è sempre necessario fare riferimento al co-installer di aggiornamento o al co-installer di configurazione. Tuttavia, facendo riferimento a entrambi i co-installer in INF, verranno generati errori di installazione.

Sezioni file INF per il co-programma di installazione

Il file INF del driver deve includere una sezione INF DDInstall.CoInstallers. Se si ridistribuisce il co-installer di aggiornamento, la sezione DDInstall.CoInstallers deve includere sia una direttiva INF AddReg che una direttiva INF CopyFiles, come illustrato nell'esempio seguente.

[MyDriver_Install.CoInstallers]
AddReg = MyDriver_Install.CoInstallers_AddReg
CopyFiles = MyDriver_CoInstallers_CopyFiles

La direttiva INF AddReg identifica una sezione INF che crea una voce del Registro di sistema CoInstallers32 .

[MyDriver_Install.CoInstallers_AddReg]
HKR,,CoInstallers32,0x00010000,"WudfUpdate_01011.dll"

La direttiva INF CopyFiles identifica una sezione INF che copia il co-installer dal dispositivo di installazione al dispositivo di sistema.

[MyDriver_CoInstallers_CopyFiles]
WudfUpdate_01011.dll

Se si ridistribuisce un pacchetto MSU, la sezione DDInstall.CoInstallers deve specificare una direttiva AddReg che fa riferimento al co-programma di installazione della configurazione.

[Echo_Install.NT.CoInstallers]
AddReg=CoInstallers_AddReg
[CoInstaller.AddReg]
HKR,,CoInstallers32,0x00010000,WudfCoinstaller.dll

Il file INF del driver deve sempre contenere una sezione DDInstall.Wdf che il co-installer legge dopo l'installazione. Per informazioni sulle direttive che il driver può specificare in DDInstall.Wdf, vedere Specifica delle direttive WDF nei file INF.

È possibile evitare di creare più file INF per più versioni del framework usando i file INX e lo strumento Stampinf . Per altre informazioni sui file INX, vedere Uso di file INX per creare file INF.