Sezione Versione INF

Per convenzione, la sezione Version viene visualizzata per prima nei file INF. Ogni file INF deve avere questa sezione.

[Version]
 
Signature="signature-name"
[Class=class-name]
[ClassGuid={nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn}]
[Provider=%INF-creator%]
[ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}]
[LayoutFile=filename.inf [,filename.inf]... ]  (Windows 2000 and Windows XP)
[CatalogFile=filename.cat]
[CatalogFile.nt=unique-filename.cat]
[CatalogFile.ntx86=unique-filename.cat]
[CatalogFile.ntia64=unique-filename.cat]  (Windows XP and later versions of Windows)
[CatalogFile.ntamd64=unique-filename.cat]  (Windows XP and later versions of Windows)
[CatalogFile.ntarm=unique-filename.cat]  (Windows 8 and later versions of Windows)
[CatalogFile.ntarm64=unique-filename.cat]  (Windows 10 version 1709 and later versions of Windows)

DriverVer=mm/dd/yyyy,w.x.y.z
[PnpLockDown=0|1] (Windows Vista and later versions of Windows)
[DriverPackageDisplayName=%driver-package-description%]
[DriverPackageType=PackageType]

Voci

Signature="signature-name"
Deve essere $Windows NT$ o $Chicago$. Indica i sistemi operativi per i quali l'INF è valido. Questi valori di firma hanno i significati seguenti.

Valore firma	Significato
$Windows NT$	Tutti i sistemi operativi Windows
$Chicago$	Tutti i sistemi operativi Windows

I caratteri del segno di dollaro di inclusione ($) sono obbligatori, ma queste stringhe non fanno distinzione tra maiuscole e minuscole. Se signature-name non è uno di questi valori stringa, il file non viene accettato come INF valido.

In genere, Windows non distingue tra questi valori di firma. Uno di essi deve essere specificato, ma non importa quale. È necessario specificare il valore appropriato in modo che un utente che legge un file INF possa determinare i sistemi operativi per i quali è previsto.

Alcuni programmi di installazione di classe specificano requisiti aggiuntivi sul modo in cui è necessario specificare il valore della firma. Tali requisiti, se presenti, vengono descritti nelle sezioni specifiche del tipo di dispositivo di questo Windows Driver Kit (WDK).

Un INF deve fornire informazioni di installazione specifiche del sistema aggiungendo estensioni definite dal sistema alle relative sezioni DDInstall , indipendentemente dal fatto che il nome della firma sia $Windows NT$ o $Chicago$. Per una descrizione di queste estensioni, vedere Creazione di file INF per più piattaforme e sistemi operativi .

Class=class-name
Per qualsiasi tipo di dispositivo standard, specifica il nome della classe di installazione del dispositivo per il tipo di dispositivo installato tramite questo file INF. Questo nome è in genere uno dei nomi di classe definiti dal sistema, ad esempio Net o Display, elencati in Devguid.h. Per altre informazioni, vedere Classi di installazione del dispositivo fornite dal sistema.

Se un INF specifica una classe, deve specificare anche il valore GUID definito dal sistema corrispondente per la relativa voce ClassGUID . Specificando il valore GUID corrispondente per un dispositivo di qualsiasi classe di configurazione del dispositivo predefinita, è possibile installare il dispositivo e i relativi driver più velocemente, perché ciò consente al codice di installazione del sistema di ottimizzare la ricerca INF.

Se un INF aggiunge una nuova classe di installazione di dispositivi al sistema, deve fornire un valore univoco senza distinzione tra maiuscole e minuscole che differisce da una delle classi fornite dal sistema in Devguid.h. La lunghezza della stringa del nome di classe deve essere di 32 caratteri o meno. InF deve specificare un valore GUID appena generato per la voce ClassGUID . Vedere anche la sezione INF ClassInstall32.

Questa voce è irrilevante per un INF che non installa né un nuovo driver di dispositivo con una classe di configurazione predefinita del dispositivo né una nuova classe di installazione del dispositivo.

Nota

Questa voce è necessaria per i driver di dispositivo installati tramite la gestione Plug and Play (PnP).

ClassGuid={nnnnnnnn-nnnn-nnnn-nnnn-nnnn nnnnnnnnnnnn}
Specifica il GUID della classe di installazione del dispositivo . Il valore GUID viene formattato come illustrato di seguito, dove ogni n è una cifra esadecimale.

Questo valore GUID specifica la classe di installazione del dispositivo da assegnare ai dispositivi installati da questo file INF. Questo valore GUID specifico della classe identifica anche il programma di installazione della classe del dispositivo per il tipo di provider di pagine delle proprietà specifico della classe e del dispositivo, se presente.

Per una nuova classe di configurazione del dispositivo, INF deve specificare un valore ClassGUID appena generato. Per altre informazioni su come creare GUID, vedere Uso dei GUID nei driver. Vedere anche Classi di installazione del dispositivo.

Nota

Questa voce è necessaria per i driver di dispositivo installati tramite la gestione PnP.

ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
Specifica il GUID dell'ID di estensione durante la creazione di un'estensione INF. Il valore GUID è formattato come illustrato di seguito, dove ogni x è una cifra esadecimale.

Quando si crea la versione iniziale di un'estensione INF, INF deve specificare un valore ExtensionId appena generato. Tuttavia, quando si aggiorna un INF di estensione esistente, ExtensionId deve rimanere lo stesso in modo che più versioni correlate dell'INF dell'estensione vengano sottoposte a versioni l'una rispetto all'altra anziché essere considerate come inf di estensione indipendenti che possono essere installate contemporaneamente nella stessa istanza del dispositivo. Per altre informazioni su come creare file INF di estensione, vedere Uso di un file INF di estensione.

Nota

Questa voce è necessaria solo quando si crea un'estensione INF, come identificato specificando Class = Extension e ClassGuid = {e2f84ce7-8efa-411c-aa69-97454ca4cb57}.

ClassVer=major.Minore
Riservato per l'uso del sistema, a meno che non sia esplicitamente richiesto da una classe di dispositivo, ad esempio Printer. Ad esempio, vedere V4 Driver INF.

Provider=%INF-creator%
Identifica il provider del file INF. In genere, questo valore viene specificato come % token OrganizationName% espanso più avanti nella sezione Stringhe del file INF. La lunghezza massima, espressa in caratteri, di un nome di provider è LINE_LEN.

Ad esempio, i file INF forniti con il sistema specificano in genere INF-creator come %Msft e definiscono Msft %% = "Microsoft" nelle sezioni Stringhe.%

Nota

Questa voce è necessaria per i driver di dispositivo installati tramite la gestione PnP.

CatalogFile=filename.cat
Specifica un catalogo (.cat) file da includere nel supporto di distribuzione di un pacchetto driver.

Quando un pacchetto driver viene inviato a Microsoft per la firma digitale, WHQL fornisce un file di catalogo per il pacchetto driver dopo che WHQL ha testato e assegnato firme digitali al pacchetto. Per altre informazioni sui test e sulla firma dei pacchetti driver IHV o OEM, vedere WHQL Release Signature.For more information about the testing and signing of IHV or OEM driver packages, see WHQL Release Signature. I file di catalogo non sono elencati nella sezione SourceDisksFiles o nella direttiva CopyFiles dell'INF. Windows presuppone che il file di catalogo si trova nella stessa posizione del file INF.

I file INF forniti dal sistema non hanno mai voci CatalogFile= perché il sistema operativo convalida la firma per tale INF in tutti i file di xxx.cat forniti dal sistema.

CatalogFile.nt=unique-filename.cat |
CatalogFile.ntx86=unique-filename.cat |
CatalogFile.ntia64=unique-filename.cat |
CatalogFile.ntamd64=unique-filename.cat
CatalogFile.ntarm=unique-filename.cat
CatalogFile.ntarm64=unique-filename.cat

Specifica un altro nome di file univoco e determinato da INF, con . estensione cat , di un file di catalogo. Se queste voci facoltative vengono omesse, viene usato un determinato CatalogFile=filename.cat per convalidare le installazioni di dispositivi/driver WDM.

Se sono presenti file CatalogFile decorati.xxx= voce esiste nella sezione Version di un INF insieme a una voce CatalogFile= non dichiarata, si presuppone che la voce non dichiarata identifichi un filename.cat per la convalida di installazioni di dispositivi, installazioni di driver o entrambe le piattaforme per le quali non è specificata una voce decorata.

Qualsiasi file INF del driver di dispositivo multipiattaforma con CatalogFile= e CatalogFile.Xxx= voci deve specificare un nome univoco determinato dall'IHV/OEM per ogni file con estensione cat.

Per altre informazioni su come usare le estensioni .nt, .ntx86, .ntia64, .ntamd64, ntarm e .ntarm64 definite dal sistema, vedere Creazione di file INF per più piattaforme e sistemi operativi.

Nota

Poiché lo stesso file con estensione cat può essere usato in tutte le piattaforme supportate, l'uso di questa voce non è obbligatorio o consigliato. Tuttavia, è necessario usare questa voce se si desidera creare file cat specifici della piattaforma per il pacchetto driver.

DriverVer=mm/dd/aaaa,w.x.y.z
Questa voce specifica le informazioni sulla versione per i driver installati da questo file INF. A partire da Windows 2000, questa voce è obbligatoria.

Per informazioni su come specificare questa voce, vedere Direttiva INF DriverVer.

PnpLockDown=0|1
Specifica se Plug and Play (PnP) impedisce alle applicazioni di modificare direttamente i file specificati dal file INF di un pacchetto driver. Se la direttiva PnpLockDown è impostata su 1, PnP impedisce alle applicazioni di modificare direttamente i file copiati dalle direttive CopyFiles INF. In caso contrario, se la direttiva non è inclusa in un file INF o il valore della direttiva è impostato su zero, un'applicazione con privilegi di amministratore può modificare direttamente questi file. I file di driver protetti in questo modo vengono definiti file di driver protetti da terze parti.

Per garantire l'integrità di un'installazione del driver PnP, le applicazioni non devono modificare direttamente i file driver copiati dal file INF del pacchetto driver. Le applicazioni devono usare solo i meccanismi di installazione dei dispositivi forniti da Windows per aggiornare i driver PnP.

A partire da Windows Vista, un pacchetto driver deve impostare PnpLockDown su 1 per impedire a un'applicazione di modificare direttamente i file del driver. Tuttavia, alcune applicazioni esistenti che disinstallano i pacchetti driver eliminano direttamente i file driver. Per mantenere la compatibilità con queste applicazioni, la direttiva PnpLockDown per tale pacchetto driver deve essere impostata su zero.

Nota

Anche se PnP in Windows Vista e versioni successive di Windows non richiede che un file INF includa una direttiva PnpLockDown per installare un driver, PnP in una versione futura di Windows potrebbe richiedere che i file INF per i pacchetti driver PnP includano la direttiva PnpLockDown .

DriverPackageDisplayName=%driver-package-description%
Deprecato. È stato usato in precedenza da Driver Install Frameworks (DIFx). Per informazioni sulla deprecazione di DIFx, vedi Linee guida per DIFx.

DriverPackageType=PackageType
Deprecato. È stato usato in precedenza da Driver Install Frameworks (DIFx). Per informazioni sulla deprecazione di DIFx, vedi Linee guida per DIFx.

Commenti

Quando un pacchetto driver supera i test di Microsoft Windows Hardware Quality Lab (WHQL), WHQL restituisce i file di catalogo cat all'IHV o all'OEM. Ogni file con estensione cat contiene una firma crittografata digitalmente per il pacchetto driver. L'IHV o l'OEM deve elencare questi file catnella sezione Versione INF e deve fornire i file nel supporto di distribuzione, nella stessa posizione del file INF. I file con estensione cat devono essere decompressi.

Nota

Se una sezione INF Version non include almeno una voce CatalogFile o CatalogFile.ntxxx, il driver viene considerato non firmato e le date elencate nella direttiva DriverVer non vengono visualizzate da Windows.

Per altre informazioni, vedere Firma del driver.

Esempio

L'esempio seguente mostra una sezione Version tipica di un semplice pacchetto driver INF, seguita dalle sezioni SourceDisksNames e SourceDisksFiles obbligatorie implicite nelle voci specificate in questa sezione Version di esempio:

[Version]
Signature="$Windows NT$"
Class=SCSIAdapter
ClassGUID={4D36E97B-E325-11CE-BFC1-08002BE10318}
Provider=%INF_Provider%
CatalogFile=example.cat
DriverVer=01/29/2010,1.2.3.4
PnpLockdown=1

[SourceDisksNames]
;
; diskid = description[, [tagfile] [, <unused>, subdir]]
;
1 = %Disk_Description%,,,\WinNT

[SourceDisksFiles.x86]
;
; filename_on_source = diskID[, [subdir][, size]]
;
exampleDriver.sys = 1,\x86

; ...

[Strings]
INF_Provider="Contoso"
Disk_Description = "Contoso Drivers Disk"
; ...

Vedi anche

DDInstall

SourceDisksNames

SourceDisksFiles

Stringhe