Acessando propriedades da classe de dispositivo

No Windows Vista e versões posteriores do Windows, aplicativos e instaladores podem acessar propriedades da classe de instalação do dispositivo e propriedades da classe de interface do dispositivo chamando as funções a seguir.

Observação

Não há suporte para SetupApi em todas as edições do Windows. Quando possível, você deve usar APIs de camada inferior, como aquelas disponíveis por meio deCfgMgr32.dll. Confira Portabilidade de SetupApi para CfgMgr32 para obter dicas.

Para obter informações sobre como acessar propriedades de classe de dispositivo no Windows Server 2003, Windows XP e Windows 2000, consulte Acessando propriedades da classe de instalação do dispositivo e Acessando propriedades da classe de interface do dispositivo.

Recuperando propriedades

APIs de propriedade, como CM_Get_Class_Property ou SetupDiGetClassProperty , podem ser usadas para recuperar uma propriedade de classe para uma classe de configuração de dispositivo ou uma classe de interface do dispositivo.

Definir propriedades

APIs de propriedade como CM_Set_Class_Property ou SetupDiSetClassProperty podem ser usadas para definir uma propriedade de classe para uma classe de configuração de dispositivo ou classe de interface do dispositivo.

Obter uma lista de propriedades disponíveis

APIs de propriedade como CM_Get_Class_Property_Keys ou SetupDiGetClassPropertyKeys podem ser usadas para recuperar uma matriz das chaves de propriedade que identificam as propriedades definidas atualmente para uma classe de configuração de dispositivo ou classe de interface do dispositivo. Isso pode ser usado para determinar o conjunto completo de propriedades definido em uma classe. No entanto, o uso dessas funções, especialmente para recuperar posteriormente o valor de todas as propriedades que essas funções indicam que estão definidas na classe , deve ser usado com moderação, pois a recuperação da lista de todas as propriedades e seus valores pode ser uma operação cara.