Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Dans Windows Vista et les versions ultérieures de Windows, le modèle unifié de propriétés d’appareil inclut des propriétés de pilote d’appareil qui caractérisent un pilote d’appareil. Le modèle de propriété de périphérique unifié utilise des clés de propriété pour représenter ces propriétés.
Windows Server 2003, Windows XP et Windows 2000 prennent également en charge la plupart de ces propriétés de pilote de périphérique. Toutefois, ces versions antérieures de Windows ne prennent pas en charge les clés de propriété du modèle unifié de propriétés de périphérique. Au lieu de cela, ces versions de Windows utilisent les mécanismes suivants pour représenter et accéder aux informations de propriété correspondantes :
- Accès aux propriétés du pilote de périphérique qui ont des valeurs d’entrée de Registre correspondantes
- Utilisation de SetupDiGetDriverInstallParams pour récupérer le rang du pilote
Pour maintenir la compatibilité avec ces versions antérieures de Windows, Windows Vista et les versions ultérieures prennent également en charge ces deux façons d’accéder aux informations relatives à une interface de périphérique. Toutefois, vous devez utiliser les clés de propriété pour accéder à ces propriétés sur Windows Vista et versions ultérieures. Pour plus d’informations sur l’utilisation des clés de propriété pour accéder aux propriétés de pilote d’appareil dans Windows Vista et versions ultérieures, consultez Accès aux propriétés de l’instance de l’appareil (Windows Vista et versions ultérieures).
Accès aux propriétés du pilote de périphérique associées à des valeurs d’entrée de registre correspondantes
Pour accéder aux propriétés du pilote de périphérique sur Windows Server 2003, Windows XP et Windows 2000, procédez comme suit :
Récupérez un handle vers la clé logicielle d’une instance d’appareil en appelant CM_Open_DevNode_Key avec un ulFlags de CM_REGISTRY_SOFTWARE ou SetupDiOpenDevRegKey avec un Scope de DICS_FLAG_GLOBAL et un KeyType de DIREG_DRV.
Fournissez le descripteur dans un appel à RegQueryValueEx ou à RegSetValueEx pour récupérer ou définir la valeur de l’entrée du Registre qui correspond à la propriété du pilote d’instance de périphérique.
Appelez la fonction RegCloseKey pour fermer la clé de registre du logiciel lorsque l’accès à la clé n’est plus nécessaire.
Le tableau des propriétés du modèle unifié de propriétés de périphérique et de leurs valeurs de Registre correspondantes dans la clé logicielle d’un appareil est le suivant :
| Propriété du modèle de propriété unifié | Nom de la valeur de la clé de registre du logiciel (défini dans regstr.h) |
|---|---|
| DEVPKEY_Device_DriverDate | REGSTR_VAL_DRIVERDATEDATA |
| DEVPKEY_Device_DriverVersion | REGSTR_VAL_DRIVERVERSION |
| DEVPKEY_Device_DriverDesc | REGSTR_VAL_DRVDESC |
| DEVPKEY_Device_DriverInfPath | REGSTR_VAL_INFPATH |
| DEVPKEY_Device_DriverInfSection | REGSTR_VAL_INFSECTION |
| DEVPKEY_Device_DriverInfSectionExt | REGSTR_VAL_INFSECTIONEXT |
| DEVPKEY_Device_DriverProvider | REGSTR_VAL_PROVIDER_NAME |
Utilisation de SetupDiGetDriverInstallParams pour récupérer le rang du pilote
Sur Windows Server 2003, Windows XP et Windows 2000, vous pouvez récupérer le rang d’un pilote actuellement installé pour un appareil en appelant SetupDiGetDriverInstallParams. SetupDiGetDriverInstallParams récupère un pointeur vers une structure SP_DRVINSTALL_PARAMS pour le pilote dans le paramètre de sortie DriverInstallParams. Le membre Rang de la structure SP_DRVINSTALL_PARAMS récupérée contient le rang du pilote.