Valeurs d’entrée de fichier INF qui modifient les propriétés de l’appareil avant Windows Vista

Voici les valeurs d’entrée de fichier INF qui modifient les propriétés de l’appareil sur Windows Server 2003, Windows XP et Windows 2000 :

• Valeurs d’entrée de fichier INF qui définissent les propriétés de l’appareil qui correspondent aux propriétés d’appareil définies par le système qui font partie du modèle de propriété d’appareil unifié dans Windows Vista et les versions ultérieures de Windows.

• Directives INF AddReg et directives INF DelReg qui définissent ou suppriment des valeurs d’entrée de Registre définies par le système qui correspondent aux propriétés d’appareil définies par le système qui font partie du modèle de propriété d’appareil unifié dans Windows Vista et versions ultérieures.

• Directives INF AddReg et directives DelReg INF qui définissent ou suppriment des valeurs d’entrée de Registre personnalisées qui correspondent aux propriétés d’appareil personnalisées.

Pour obtenir des informations générales sur les sections de fichier INF qui installent des instances d’appareil, des classes d’installation d’appareil, des classes d’interface d’appareil et des interfaces d’appareil, consultez les rubriques suivantes :

• Section DDInstall INF
• INF ClassInstall32 Section
• INF InterfaceInstall32 Section
• INF DDInstall. Interfaces Section

Valeurs d’entrée de fichier INF qui correspondent aux propriétés de l’appareil System-Defined

Certaines valeurs d’entrée de fichier INF fournissent des informations que Windows utilise pour définir les valeurs d’entrée de Registre définies par le système qui correspondent aux propriétés d’instance d’appareil et aux propriétés d’interface de l’appareil. Voici quelques exemples de valeurs d’entrée de Registre fournies par ces valeurs d’entrée de fichier INF :

• La section Modèles INF d’un fichier INF inclut une valeur d’entrée de description d’appareil . Cette valeur correspond à la propriété DEVPKEY_Device_DeviceDesc dans le modèle de propriété d’appareil unifié et peut être récupérée en appelant CM_Get_DevNode_Registry_Property avec un paramètre ulProperty de CM_DRP_DEVICEDESC ou en appelant SetupDiGetDeviceRegistryProperty avec un paramètre Property de SPDRP_DEVICEDESC.

• La directive INF Class d’une section Version INF inclut une valeur d’entrée de nom de classe qui fournit le nom d’une classe d’installation d’appareil. Cette valeur correspond à la propriété DEVPKEY_DeviceClass_ClassName dans le modèle de propriété d’appareil unifié. Le nom de classe d’une classe de configuration d’appareil peut être récupéré en appelant SetupDiClassNameFromGuid, et le nom de classe d’une instance d’appareil peut être récupéré en appelant CM_Get_DevNode_Registry_Property avec un paramètre ulProperty de CM_DRP_CLASS ou en appelant SetupDiGetDeviceRegistryProperty avec un paramètre Property de SPDRP_CLASS.

• La section INF InterfaceInstall32 inclut une valeur d’entrée InterfaceClassGuid qui fournit le GUID d’une interface d’appareil. Cette valeur correspond à la propriété DEVPKEY_DeviceInterface_ClassGuid dans le modèle de propriété d’appareil unifié. Le GUID d’une interface d’appareil peut être récupéré en appelant SetupDiEnumDeviceInterfaces, qui récupère une structure SP_DEVICE_INTERFACE_DATA pour les interfaces d’appareil associées à une instance d’appareil. Le membre InterfaceClassGuid de la structure SP_DEVICE_INTERFACE_DATA identifie le GUID de la classe d’interface.

Directives INF AddReg et directives DelReg INF qui modifient les propriétés de l’appareil System-Defined

De nombreuses propriétés d’appareil définies par le système ont des valeurs d’entrée de Registre définies par le système correspondantes. Pour les propriétés d’appareil qui ont des valeurs d’entrée de Registre correspondantes, l’utilisation d’une directive AddReg INF pour ajouter la valeur d’entrée de Registre correspondante définit la propriété d’appareil correspondante. De même, l’utilisation d’une directive DelReg INF pour supprimer la valeur d’entrée de Registre correspondante supprime également la propriété d’appareil correspondante.

Par exemple, la directive ADDReg INF dans la section « Abc_Device_Install.HW » suivante définit la valeur d’entrée de Registre DeviceCharacteristics pour une instance d’appareil :

[Abc_Device_Install.HW]
...
AddReg = Xxx_AddReg
...
[Xxx_AddReg]
...
[HKR,,DeviceCharacteristics,0x10001,0x00000001
] 

La valeur d’entrée de Registre DeviceCharacteristics correspond à la propriété DEVPKEY_Device_Characteristics dans le modèle de propriété d’appareil unifié dans Windows Vista et les versions ultérieures de Windows.

Directives INF AddReg et directives INF DelReg qui modifient les valeurs d'entrée du registre personnalisées

Windows gère la correspondance entre les valeurs d’entrée de Registre définies par le système et les propriétés d’appareil définies par le système. Toutefois, Windows ne gère pas la correspondance entre les valeurs d’entrée de Registre personnalisées et les propriétés d’appareil personnalisées. Une directive INF AddReg ou une directive INF DelReg qui modifie une valeur d’entrée de Registre personnalisée n’affecte pas les propriétés définies par le système gérées par Windows.

Les propriétés d’instance d’appareil personnalisées définies comme indiqué dans l’exemple suivant peuvent être récupérées en appelant SetupDiGetCustomDeviceProperty.

[XxxDDInstall.HW]
...
AddReg = Xxx_AddReg
...
[Xxx_AddReg]
...
[HKR,,CustomPropertyName,0x10001,0x00000001
] 

Pour plus d’informations sur l’accès aux propriétés d’appareil personnalisées qui ont des valeurs d’entrée de Registre personnalisées correspondantes, consultez Accès aux propriétés d’appareil personnalisé.