Accessing Device Setup Class Properties
In Windows Vista and later versions of Windows, the unified device property model includes the following:
- Device setup class properties that correspond to the CM_CRP_Xxx identifiers that are defined in cfgmgr32.h or SPCRP_Xxx identifiers that are defined in Setupapi.h.
- Properties that do not have CM_CRP_Xxx or SPCRP_Xxx identifiers, but do have corresponding ways to query the values.
Properties that correspond to CM_CRP_Xxx or SPCRP_Xxx identifiers
In Windows Vista and later versions of Windows, the unified device property model supports the device setup class properties that correspond to the CM_CRP_Xxx identifiers that are defined in cfgmgr32.h and the SPCRP_Xxx identifiers that are defined in Setupapi.h. These properties characterize a device setup class. The unified device property model uses property keys to represent these properties. Windows Server 2003, Windows XP, and Windows 2000 also support most of these device setup class properties. However, these earlier versions of Windows do not support the property keys of the unified device property model. Instead, these versions of Windows versions use the CM_CRP_Xxx or SPCRP_Xxx identifiers to represent and access the device setup class properties.
To maintain compatibility with earlier versions of Windows, Windows Vista and later versions also support using CM_CRP_Xxx or SPCRP_Xxx identifiers to access device setup class properties. However, you should use the property keys of the unified device property model to access device setup class properties.
For a list of the system-defined device setup class properties that have corresponding CM_CRP_Xxx or SPCRP_Xxx identifiers, see the following table.
| Unified property model property | CM_CRP_Xxx value | SPCRP_Xxx value |
|---|---|---|
| DEVPKEY_DeviceClass_Security | CM_CRP_SECURITY | SPCRP_SECURITY |
| DEVPKEY_DeviceClass_SecuritySDS | CM_CRP_SECURITY_SDS | SPCRP_SECURITY_SDS |
| DEVPKEY_DeviceClass_DevType | CM_CRP_DEVTYPE | SPCRP_DEVTYPE |
| DEVPKEY_DeviceClass_Exclusive | CM_CRP_EXCLUSIVE | SPCRP_EXCLUSIVE |
| DEVPKEY_DeviceClass_Characteristics | CM_CRP_CHARACTERISTICS | SPCRP_CHARACTERISTICS |
For information about how to access device setup class properties in Windows Vista and later versions, see Accessing Device Class Properties (Windows Vista and Later).
Accessing a Device Setup Class Property
To access device setup class properties that correspond to the CM_CRP_Xxx or SPCRP_Xxx identifiers on Windows Server 2003, Windows XP, and Windows 2000, use the following functions:
CM_Get_Class_Registry_Property or SetupDiGetClassRegistryProperty to retrieve a property.
CM_Set_Class_Registry_Property or SetupDiSetClassRegistryProperty to set a property.
Properties that do not have CM_CRP_Xxx or SPCRP_Xxx identifiers
For information about how to access the corresponding device setup class properties on Windows Server 2003, Windows XP, and Windows 2000, see the following topics:
Accessing the Friendly Name and Class Name of a Device Setup Class