DEVPKEY_Device_MatchingDeviceId

The DEVPKEY_Device_MatchingDeviceId device property represents the hardware ID or compatible ID that Windows uses to install a device instance.

Attribute Value

Property key

DEVPKEY_Device_MatchingDeviceId

Property-data-type identifier

DEVPROP_TYPE_STRING

Property access

Read-only access by installation applications and installers

Corresponding registry value identifier and registry value name

REGSTR_VAL_MATCHINGDEVICEID

MatchingDeviceId

Localized?

No

Remarks

Windows sets the value of DEVPKEY_Device_MatchingDeviceId. The hardware IDs and compatible IDs for a device are supplied by the device-description entries that are included in the INF Models section of the INF file that installs a device.

You can call CM_Get_DevNode_Property or SetupDiGetDeviceProperty to retrieve the value of DEVPKEY_Device_MatchingDeviceId.

Windows Server 2003, Windows XP, and Windows 2000 support this property, but do not support the DEVPKEY_Device_MatchingDeviceId property key. On these earlier versions of Windows, you can access the value of this property by accessing the corresponding MatchingDeviceId registry value under the software key for the device instance. For information about how to access this property value on these earlier versions of Windows, see Accessing Device Driver Properties.

Requirements

Version: Windows Vista and later versions of Windows Header: Devpkey.h (include Devpkey.h)

See also

INF Models Section

SetupDiGetDeviceProperty