Compartilhar via


Acessando configurações personalizadas

No Windows Vista e versões posteriores do Windows, o modelo de propriedade do dispositivo unificado dá suporte ao uso de chaves de propriedade para criar e acessar propriedades personalizadas do dispositivo. Para obter mais informações, consulte Criando propriedades de dispositivo personalizadas.

No Windows Server 2003, Windows XP e Windows 2000, você pode criar valores de entrada de registro personalizados sob as chaves do Registro fornecidas pelo sistema para um componente relacionado ao dispositivo. A lista a seguir contém a função SetupAPI a ser chamada para cada tipo de componente do dispositivo para abrir a chave do Registro fornecida pelo sistema correspondente. Depois de abrir a chave do Registro definida pelo sistema, os aplicativos e instaladores podem chamar as funções do Registro baseadas no Windows para modificar valores de entrada do Registro personalizados sob a chave do Registro aberta.

  • Um valor de entrada de registro personalizado para uma propriedade de hardware de instância de dispositivo deve estar localizado sob a chave do registro de hardware de uma instância de dispositivo. Chame SetupDiOpenDevRegKey e forneça DIREG_DEV no parâmetro Flags para recuperar um identificador para a chave de hardware de uma instância de dispositivo. Os valores de entrada do Registro personalizados definidos sob a chave do Registro de hardware para uma instância de dispositivo podem ser recuperados chamando a função SetupDiGetCustomDeviceProperty .

  • Um valor de entrada de registro personalizado para uma propriedade de software de instância de dispositivo deve estar localizado sob a chave do registro de software de uma instância de dispositivo. Chame SetupDiOpenDevRegKey e forneça DIREG_DRV no parâmetro Flags para recuperar um identificador para a chave de software de uma instância de dispositivo.

  • Um valor de entrada de registro personalizado para uma propriedade de classe de configuração de dispositivo deve estar localizado na chave do Registro da classe de instalação do dispositivo. Chame SetupDiOpenClassRegKeyEx e forneça DIOCR_INSTALLER no parâmetro Flags para recuperar um identificador para a chave do Registro para uma classe de configuração de dispositivo.

  • Um valor de entrada de registro personalizado para uma propriedade de classe de interface do dispositivo deve estar localizado sob a chave do Registro da classe de interface do dispositivo. Chame SetupDiOpenClassRegKeyEx e forneça DIOCR_INTERFACE no parâmetro Flags para recuperar um identificador para a chave do Registro de uma classe de interface do dispositivo.

  • Um valor de entrada de registro personalizado para uma propriedade de interface do dispositivo deve estar localizado sob a chave do Registro da interface do dispositivo. Chame SetupDiOpenDeviceInterfaceRegKey para recuperar um identificador para a chave do Registro de uma classe de interface do dispositivo.

Depois de recuperar um identificador para uma chave do Registro, forneça o identificador em uma chamada para RegQueryValueEx ou RegSetValueEx para recuperar ou definir o valor de entrada do Registro personalizado que corresponde à propriedade de dispositivo personalizada.

Chame a função RegCloseKey para fechar a chave do Registro depois que o acesso à chave do Registro não for mais necessário.