Acessando propriedades da interface do dispositivo

No Windows Vista e versões posteriores do Windows, aplicativos e instaladores podem acessar as propriedades da 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 da interface do dispositivo no Windows Server 2003, Windows XP e Windows 2000, consulte Acessando propriedades da interface do dispositivo.

Recuperando propriedades

APIs de propriedade como CM_Get_Device_Interface_Property ou SetupDiGetDeviceInterfaceProperty podem ser usadas para recuperar uma propriedade de interface do dispositivo.

Definir propriedades

APIs de propriedade como CM_Set_Device_Interface_Property ou SetupDiSetDeviceInterfaceProperty podem ser usadas para definir uma propriedade de interface do dispositivo.

Obter uma lista de propriedades disponíveis

APIs de propriedade como CM_Get_Device_Interface_Property_Keys ou SetupDiGetDeviceInterfacePropertyKeys podem ser usadas para recuperar uma matriz das chaves de propriedade que identificam as propriedades definidas atualmente para uma interface do dispositivo. Isso pode ser usado para determinar o conjunto completo de propriedades definidas em uma interface do dispositivo. No entanto, o uso dessas funções, especialmente para recuperar posteriormente o valor de todas as propriedades que essas funções indicam serem definidas na interface do dispositivo, 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.