Annexe B : Exemple de fichier INF fourni par un fournisseur et utilisable sous Windows Vista

Cette annexe comprend un exemple de mise en œuvre d'un fichier INF fourni par un fournisseur et faisant référence à Bth.inf. Cet exemple particulier est mis en œuvre pour installer une radio compatible avec la version 2.0 plus EDR de la spécification Bluetooth dans Windows XP ou Windows Vista. Les fichiers INF pour d'autres types d'appareils Bluetooth sont similaires.

Ce fichier INF peut être utilisé pour installer l'appareil sur les versions suivantes de Windows :

• Toutes les UGS de la version 32 bits de Windows XP SP2 et des Service Packs ultérieurs.
• Toutes les UGS de la version 64 bits de Windows XP
• Toutes les UGS de Windows Vista

Pour une explication des sections et directives surlignées, consultez les notes numérotées après l'exemple suivant :

; 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"

Remarques :

1. Dans la section Version, les directives CLASSGUID et DriverVer doivent être définies comme suit :

   • CLASSGUID : Utilisez le GUID de la classe Microsoft pour les appareils Bluetooth ({e0cbf06c cd8b-4647-bb8a-263b43f0f974}), et non un GUID tiers.
   • DriverVer : Si vous souhaitez remplacer le pilote intégré par défaut, la date et la version du pilote doivent être définies de manière à fournir une correspondance de rang supérieur à ce qui figure dans Bth.inf. Pour plus d'informations, voir Comment Windows classe les packages de pilotes.

2. ID de matériel. La combinaison du VID et du PID doit être unique pour le fabricant et l'appareil. Cela permet de s'assurer que le même ID matériel ne correspond pas à plusieurs appareils.

3. Directives Include et Needs. Les directives Include de ces trois sections font référence à Bth.inf. Les directives Needs indiquent quelles sections de Bth.inf doivent être traitées lors de l'installation de l'appareil.

4. La directive DelReg, qui fait référence à la section DeleteRegKeys, supprime les clés ou valeurs de registre qui empêchent Windows de créer un PDO ou un devnode pour un appareil. Par exemple, le profil de service de télécopie figure actuellement sur la liste des services non pris en charge de Windows Vista, il s'agit donc d'une valeur de la clé de registre UnsupportedServices. Cet exemple supprime le profil de services de télécopie de la clé UnsupportedServices, ce qui permet à Windows de créer un devnode pour l'appareil.

Nous vous recommandons vivement d'exécuter les derniers tests WHQL sur l'appareil et le fichier INF et de publier le package du fichier INF sur Windows Update. Ainsi, les clients pourront télécharger automatiquement le fichier INF sur Internet lorsqu'ils connecteront leur nouvelle radio Bluetooth à leur ordinateur.