Accès aux propriétés de l’instance d’appareil (avant Windows Vista)
Dans Windows Vista et les versions ultérieures de Windows, le modèle de propriété d’appareil unifié prend en charge les propriétés de instance d’appareil qui correspondent aux identificateurs CM_DRP_Xxx définis dans cfgmgr32.h et aux identificateurs SPDRP_Xxx définis dans Setupapi.h. Ces propriétés caractérisent la configuration d’un appareil instance. Le modèle de propriété d’appareil 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 ces propriétés d’appareil. Toutefois, ces versions antérieures de Windows ne prennent pas en charge les clés de propriété du modèle de propriété d’appareil unifié. Au lieu de cela, ces versions antérieures de Windows utilisent les identificateurs CM_DRP_Xxx ou SPDRP_Xxx pour représenter et accéder aux propriétés de instance de l’appareil.
Pour maintenir la compatibilité avec ces versions antérieures de Windows, Windows Vista et les versions ultérieures prennent également en charge l’utilisation d’identificateurs CM_DRP_Xxx ou SPDRP_Xxx pour accéder aux propriétés de instance d’appareil. Toutefois, vous devez utiliser les clés de propriété correspondantes pour accéder à ces propriétés sur Windows Vista et les versions ultérieures de Windows.
Pour obtenir la liste des propriétés de instance d’appareil définies par le système qui ont des identificateurs de SPDRP_Xxx ou de CM_DRP_Xxx correspondants, consultez le tableau suivant.
Propriété de modèle de propriété unifiée | CM_DRP_Xxx valeur | SPDRP_Xxx valeur |
---|---|---|
DEVPKEY_Device_DeviceDesc | CM_DRP_DEVICEDESC | SPDRP_DEVICEDESC |
DEVPKEY_Device_HardwareIds | CM_DRP_HARDWAREID | SPDRP_HARDWAREID |
DEVPKEY_Device_CompatibleIds | CM_DRP_COMPATIBLEIDS | SPDRP_COMPATIBLEIDS |
DEVPKEY_Device_Service | CM_DRP_SERVICE | SPDRP_SERVICE |
DEVPKEY_Device_Class | CM_DRP_CLASS | SPDRP_CLASS |
DEVPKEY_Device_ClassGuid | CM_DRP_CLASSGUID | SPDRP_CLASSGUID |
DEVPKEY_Device_ConfigFlags | CM_DRP_CONFIGFLAGS | SPDRP_CONFIGFLAGS |
DEVPKEY_Device_Manufacturer | CM_DRP_MFG | SPDRP_MFG |
DEVPKEY_Device_FriendlyName | CM_DRP_FRIENDLYNAME | SPDRP_FRIENDLYNAME |
DEVPKEY_Device_LocationInfo | CM_DRP_LOCATION_INFORMATION | SPDRP_LOCATION_INFORMATION |
DEVPKEY_Device_PDOName | CM_DRP_PHYSICAL_DEVICE_OBJECT_NAME | SPDRP_PHYSICAL_DEVICE_OBJECT_NAME |
DEVPKEY_Device_Capabilities | CM_DRP_CAPABILITIES | SPDRP_CAPABILITIES |
DEVPKEY_Device_UINumber | CM_DRP_UI_NUMBER | SPDRP_UI_NUMBER |
DEVPKEY_Device_BusTypeGuid | CM_DRP_BUSTYPEGUID | SPDRP_BUSTYPEGUID |
DEVPKEY_Device_LegacyBusType | CM_DRP_LEGACYBUSTYPE | SPDRP_LEGACYBUSTYPE |
DEVPKEY_Device_BusNumber | CM_DRP_BUSNUMBER | SPDRP_BUSNUMBER |
DEVPKEY_Device_EnumeratorName | CM_DRP_ENUMERATOR_NAME | SPDRP_ENUMERATOR_NAME |
DEVPKEY_Device_Security | CM_DRP_SECURITY | SPDRP_SECURITY |
DEVPKEY_Device_SecuritySDS | CM_DRP_SECURITY_SDS | SPDRP_SECURITY_SDS |
DEVPKEY_Device_DevType | CM_DRP_DEVTYPE | SPDRP_DEVTYPE |
DEVPKEY_Device_Exclusive | CM_DRP_EXCLUSIVE | SPDRP_EXCLUSIVE |
DEVPKEY_Device_Characteristics | CM_DRP_CHARACTERISTICS | SPDRP_CHARACTERISTICS |
DEVPKEY_Device_Address | CM_DRP_ADDRESS | SPDRP_ADDRESS |
Pour plus d’informations sur l’utilisation des clés de propriété pour accéder aux propriétés de instance d’appareil dans Windows Vista et les versions ultérieures de Windows, consultez Accès aux propriétés de l’instance d’appareil (Windows Vista et versions ultérieures).
Accès à une propriété d’appareil
Pour accéder aux propriétés de instance d’appareil qui correspondent aux identificateurs CM_DRP_Xxx ou SPDRP_Xxx sur Windows Server 2003, Windows XP et Windows 2000, utilisez les fonctions suivantes :
CM_Get_DevNode_Registry_Property ou SetupDiGetDeviceRegistryProperty pour récupérer une propriété.
CM_Set_DevNode_Registry_Property ou SetupDiSetDeviceRegistryProperty pour définir une propriété.