Appendice B: Esempio di un file INF fornito dal fornitore da usare in Windows Vista

Questa appendice include un esempio di come implementare un file INF fornito dal fornitore che fa riferimento a Bth.inf. Questo particolare esempio viene implementato per installare una radio compatibile con la versione 2.0 più EDR della specifica Bluetooth in Windows XP o Windows Vista. I file INF per altri tipi di dispositivi Bluetooth sono simili.

Questo file INF può essere usato per installare il dispositivo nelle versioni seguenti di Windows:

• Tutti gli SKU della versione a 32 bit di Windows XP SP2 e dei Service Pack successivi.
• Tutti gli SKU della versione a 64 bit di Windows XP
• Tutti gli SKU di Windows Vista

Per una spiegazione delle sezioni e delle direttive evidenziate, vedere le note numerate dopo l'esempio seguente:

; XYZ Vendor INF File for Bluetooth Radio
;
; A sample INF for a stand-alone Bluetooth radio that does not
; have native Windows Vista support

; [1]
 [Version]
Signature            = "$Windows NT$"
Provider             = %ProviderName%
Class                = Bluetooth
CLASSGUID            = {e0cbf06c-cd8b-4647-bb8a-263b43f0f974};
DriverVer            = 10/28/2006,6.0.0.0                    ;
CatalogFile.NT     = BTHXYZ1.CAB

 [ControlFlags]
ExcludeFromSelect=*

[SourceDisksNames]
1=%SourceDisk%,,1

[Manufacturer]
%ManufacturerName% = XYZBth,NT.5.1,NTx86,NTamd64

; Match on a hardware ID generated by the device, for x86 and x64.

; [2]
[ZYXBth.NT.5.1]
%BthRadio1%        = Bt1.NT.5.1, USB\VID_xxxx&PID_yyyy
[ZYXBth.NTx86]
% BthRadio1%       = Bt1.NT.5.1, USB\VID_xxxx&PID_yyyy
[ZYXBth.NTamd64]
% BthRadio1%       = Bt1.NT.5.1, USB\VID_xxxx&PID_yyyy

; Windows XP specific sections -------------------------

; [3]
[Bt1.NT.5.1]
include         = bth.inf
needs           = BthUsb.NT

[Bt1.NT.5.1.HW]
include     = bth.inf
needs       = BthUsb.NT.HW
DelReg      = DeleteRegKeys

[Bt1.NT.5.1.Services]
include     = bth.inf
needs       = BthUsb.NT.Services

; [4]
[DeleteRegKeys]
; Delete support for the Microsoft FaxService
HKLM,"SYSTEM\CurrentControlSet\Services\Bthport\Parameters\UnsupportedServices","{00001111-0000-1000-8000-00805f9b34fb}"

[Strings]
; While strings are localizable, in this sample INF, we have
; not created any localized strings.
ProviderName     = "Vendor XYZ (c)"
ManufacturerName = "Vendor XYZ (c)"
BthRadio1        = "Bluetooth 2.0+EDR Model 3.2 from XYZ (c)"
SourceDisk       = "Windows Vista CD"

Note:

1. La sezione Version deve avere le direttive CLASSGUID e DriverVer impostate come segue:

   • CLASSGUID: usare il GUID della classe Microsoft per i dispositivi Bluetooth ({e0cbf06c cd8b-4647-bb8a-263b43f0f974}), non un GUID di terze parti.
   • DriverVer: se si vuole sostituire il driver predefinito in-box, la data e la versione del driver devono essere impostate per fornire una corrispondenza di classificazione superiore a quella in Bth.inf. Per altre informazioni, vedere Modalità di classificazione dei pacchetti driver di Windows

2. ID hardware. La combinazione del VID e del PID deve essere univoca per il produttore e il dispositivo. Ciò garantisce che lo stesso ID hardware non corrisponda a più dispositivi.

3. Includere e esigenze direttive. Le direttive Include in queste tre sezioni fanno riferimento a Bth.inf. Le direttive Needs indicano quali sezioni di Bth.inf devono essere elaborate durante l'installazione del dispositivo.

4. La direttiva DelReg , che fa riferimento alla sezione DeleteRegKeys , elimina le chiavi o i valori del Registro di sistema che impediscono a Windows di creare un PDO o un nodo di sviluppo per un dispositivo. Ad esempio, il profilo del servizio fax è attualmente presente nell'elenco windows Vista di servizi non supportati, pertanto è un valore della chiave del Registro di sistema UnsupportedServices . In questo esempio il profilo dei servizi fax viene eliminato dalla chiave UnsupportedServices , che consente a Windows di creare un nodo devnode per il dispositivo.

È consigliabile eseguire i test WHQL più recenti nel dispositivo e nel file INF e pubblicare il pacchetto di file INF in Windows Update. In questo modo, i clienti possono scaricare automaticamente il file INF da Internet quando connettono la nuova radio Bluetooth al computer.