Controllo delle versioni della libreria framework

In questo argomento verranno fornite informazioni sulle convenzioni di denominazione per i nomi di file della libreria Kernel-Mode Driver Framework (KMDF) e sulla libreria User-Mode Driver Framework (UMDF).

KMDF

Un numero di versione principale e un numero di versione secondaria vengono assegnati a ogni versione della libreria KMDF. Il nome del file della libreria contiene il numero di versione principale. Il formato del nome file è:

Cdr<MajorVersionNumber>000.sys

Il numero di versione principale usa due caratteri. Ad esempio, il nome del file per la versione 1.0 della libreria è Wdf01000.sys. Le versioni 1.9, 1.11 e così via sono denominate ancheWdf01000.syse ogni nuova versione secondaria del file di libreria sovrascrive la versione precedente del file.

Se il driver è stato compilato usando una versione della libreria KMDF più recente rispetto alla versione del framework presente nel sistema, è necessario aggiornare quest'ultimo. Per informazioni sull'aggiornamento della libreria framework, vedere Redistributable Framework Components.

Si noti che il nome del file del co-programma di installazione del framework include sia i numeri di versione principali che secondari. Per altre informazioni sui nomi dei file di co-installazione, vedere Uso del co-programma di installazione kmDF.

Quando si compila il driver, l'utilità MSBuild collega il driver a un file stub contenente il numero di versione della libreria usata dall'utilità MSBuild. Quando il sistema operativo carica il driver, il caricatore del framework controlla le informazioni sulla versione nel stub del driver per determinare se il driver verrà eseguito con la versione della libreria del framework nel sistema.

Per determinare la versione della libreria con cui è in esecuzione il driver, il driver può chiamare WdfDriverIsVersionAvailable o WdfDriverRetrieveVersionString.

WDF consente di creare un driver usando una versione diversa di Windows rispetto a quella in cui verrà eseguito il driver. Per altre informazioni, vedere Creazione di un driver WDF per più versioni di Windows.

Per informazioni sulla cronologia delle versioni della libreria KMDF, vedere Cronologia delle versioni kmDF.

UMDF

Come con KMDF, il numero di versione principale della libreria UMDF usa due caratteri. Tuttavia, il numero di versione principale viene visualizzato solo nel nome del file della libreria UMDF a partire da UMDF versione 2.0.

Per UMDF versione 2.0, il nome file della libreria UMDF è Wudfx02000.dll.

Per UMDF versione 1. x, il nome del file della libreria UMDF è Wudfx.dll.

Per informazioni sulla cronologia delle versioni della libreria KMDF, vedere Cronologia delle versioni di UMDF.