Acessando propriedades do driver de dispositivo
No Windows Vista e versões posteriores do Windows, o modelo de propriedade do dispositivo unificado inclui propriedades de driver de dispositivo que caracterizam um driver 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 à maioria dessas propriedades de driver de 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 do Windows usam os seguintes mecanismos para representar e acessar as informações de propriedade correspondentes:
- Acessando propriedades do driver de dispositivo que têm valores de entrada do Registro correspondentes
- Usando SetupDiGetDriverInstallParams para recuperar a classificação do driver
Para manter a compatibilidade com essas versões anteriores do Windows, o Windows Vista e versões posteriores também dão suporte a essas duas maneiras de acessar informações sobre uma interface do dispositivo. No entanto, você deve usar as chaves de propriedade para acessar essas propriedades no Windows Vista e versões posteriores. Para obter informações sobre como usar chaves de propriedade para acessar as propriedades do driver de dispositivo no Windows Vista e versões posteriores, consulte Acessando propriedades da instância do dispositivo (Windows Vista e Posterior).
Acessando propriedades do driver de dispositivo que têm valores de entrada do Registro correspondentes
Para acessar as propriedades do driver de dispositivo no Windows Server 2003, Windows XP e Windows 2000, siga estas etapas:
Recupere um identificador para a chave de software de uma instância de dispositivo chamando CM_Open_DevNode_Key com um ulFlags de CM_REGISTRY_SOFTWARE ou SetupDiOpenDevRegKey com um Escopo de DICS_FLAG_GLOBAL e um KeyType de DIREG_DRV.
Forneça o identificador em uma chamada para RegQueryValueEx ou regSetValueEx para recuperar ou definir o valor de entrada do Registro que corresponde à propriedade do driver de instância do dispositivo.
Chame a função RegCloseKey para fechar a chave do registro de software depois que o acesso à chave não for mais necessário.
Uma tabela de propriedades unificadas do modelo de propriedade do dispositivo e seus valores de registro correspondentes na chave de software de um dispositivo é:
| Propriedade do modelo de propriedade unificada | Nome do valor do registro de chave de software (definido em 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 |
Usando SetupDiGetDriverInstallParams para recuperar a classificação do driver
No Windows Server 2003, Windows XP e Windows 2000, você pode recuperar a classificação de um driver instalado atualmente para um dispositivo chamando SetupDiGetDriverInstallParams. SetupDiGetDriverInstallParams recupera um ponteiro para uma estrutura SP_DRVINSTALL_PARAMS para o driver no parâmetro de saída DriverInstallParams. O membro Rank da estrutura de SP_DRVINSTALL_PARAMS recuperada contém a classificação do driver.