Acessando propriedades da instância do dispositivo (antes do Windows Vista)
No Windows Vista e versões posteriores do Windows, o modelo de propriedade do dispositivo unificado dá suporte às propriedades de instância do dispositivo que correspondem aos identificadores CM_DRP_Xxx definidos no cfgmgr32.h e aos identificadores de SPDRP_Xxx definidos em Setupapi.h. Essas propriedades caracterizam a configuração de uma instância de dispositivo. O modelo de propriedade do dispositivo unificado usa chaves de propriedade para representar essas propriedades. O Windows Server 2003, o Windows XP e o Windows 2000 também dão suporte a essas propriedades do dispositivo. No entanto, essas versões anteriores do Windows não dão suporte às chaves de propriedade do modelo de propriedade do dispositivo unificado. Em vez disso, essas versões anteriores do Windows usam os identificadores CM_DRP_Xxx ou SPDRP_Xxx para representar e acessar as propriedades da instância do dispositivo.
Para manter a compatibilidade com essas versões anteriores do Windows, o Windows Vista e versões posteriores também dão suporte ao uso de identificadores CM_DRP_Xxx ou SPDRP_Xxx para acessar as propriedades da instância do dispositivo. No entanto, você deve usar as chaves de propriedade correspondentes para acessar essas propriedades no Windows Vista e versões posteriores do Windows.
Para obter uma lista das propriedades de instância de dispositivo definidas pelo sistema que têm identificadores de CM_DRP_Xxx ou SPDRP_Xxx correspondentes, consulte a tabela a seguir.
Propriedade do modelo de propriedade unificada | CM_DRP_Xxx valor | SPDRP_Xxx valor |
---|---|---|
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 |
Para obter informações sobre como usar chaves de propriedade para acessar propriedades de instância de dispositivo no Windows Vista e versões posteriores do Windows, consulte Acessando propriedades de instância de dispositivo (Windows Vista e posterior).
Acessando uma propriedade de dispositivo
Para acessar propriedades de instância de dispositivo que correspondem aos identificadores CM_DRP_Xxx ou SPDRP_Xxx no Windows Server 2003, Windows XP e Windows 2000, use as seguintes funções:
CM_Get_DevNode_Registry_Property ou SetupDiGetDeviceRegistryProperty para recuperar uma propriedade.
CM_Set_DevNode_Registry_Property ou SetupDiSetDeviceRegistryProperty para definir uma propriedade.