Funções que simplificam a instalação do driver

  • Artigo

Um aplicativo de instalação pode usar as funções a seguir para simplificar a instalação de um pacote de driver PnP.

DiInstallDevice (Windows Vista e versões posteriores do Windows)

A função DiInstallDevice instala um pacote de driver específico pré-instalado no Repositório de Driver em um dispositivo específico presente no sistema.

Um aplicativo de instalação só deverá usar essa função se ambos os seguintes forem verdadeiros:

  • O aplicativo incorpora mais de uma instância de dispositivo do mesmo tipo, ou seja, todas as instâncias do dispositivo têm as mesmas IDs de hardware e IDs compatíveis.

  • O aplicativo exige que os pacotes de driver específicos da instância do dispositivo sejam instalados nas instâncias do dispositivo.

Caso contrário, um aplicativo de instalação deve usar DiInstallDriver ou UpdateDriverForPlugAndPlayDevices para instalar o pacote de driver que é a melhor correspondência para um dispositivo.

Um chamador também pode chamar DiInstallDevice para fazer o seguinte:

  • Pesquise um pacote de driver pré-instalado que seja a melhor correspondência para o dispositivo.

  • Instale um driver nulo em um dispositivo específico.

  • Notifique o chamador se uma reinicialização do sistema é necessária para concluir a instalação.

DiInstallDriver (Windows Vista e versões posteriores do Windows)

A função DiInstallDriver pré-instala um pacote de driver no Repositório de Driver e instala o pacote de driver em todos os dispositivos presentes no sistema que têm uma ID de hardware ou uma ID compatível que corresponde ao pacote de driver.

Chamar DiInstallDriver ou UpdateDriverForPlugAndPlayDevices é a maneira mais simples de um aplicativo de instalação instalar um novo pacote de driver para um dispositivo. DiInstallDriver e UpdateDriverForPlugAndPlayDevices executam as mesmas operações básicas de instalação. No entanto , UpdateDriverForPlugAndPlayDevices dá suporte a opções de instalação adicionais.

Por padrão, o DiInstallDriver só instala o pacote de driver em um dispositivo se o pacote de driver for uma correspondência melhor para o dispositivo do que o pacote de driver instalado no momento no dispositivo. Para obter informações sobre como o Windows seleciona um pacote de driver para o dispositivo, consulte Como o Windows seleciona drivers.

Um chamador também pode chamar DiInstallDriver para fazer o seguinte:

  • Force a instalação do pacote de driver especificado, independentemente de o pacote de driver ser uma correspondência melhor para o dispositivo do que o pacote de driver instalado no momento no dispositivo.

    Cuidado Forçar a instalação do pacote de driver pode resultar na substituição de um pacote de driver mais compatível ou mais recente por um pacote de driver menos compatível ou mais antigo.

  • Indique ao chamador se uma reinicialização do sistema é necessária para concluir a instalação.

DiRollbackDriver (Windows Vista e versões posteriores do Windows)

A função DiRollbackDriver substitui o pacote de driver atualmente instalado em um dispositivo pelo pacote de driver de backup instalado anteriormente definido para um dispositivo. Essa função é fornecida principalmente para restaurar um dispositivo para uma condição de trabalho se um dispositivo falhar depois de atualizar o pacote de driver para o dispositivo. Essa função executa a mesma operação que seria executada se um usuário clicasse em Reverter Driver na página Driver do dispositivo no Gerenciador de Dispositivos.

O Windows mantém no máximo um pacote de driver de backup para um dispositivo. O Windows define um pacote de driver como o driver de backup de um dispositivo imediatamente após o pacote de driver ser instalado com êxito no dispositivo e o Windows determina que o dispositivo está funcionando corretamente. No entanto, se um pacote de driver não for instalado com êxito em um dispositivo ou o dispositivo não funcionar corretamente após a instalação, o Windows não definirá o pacote de driver como o driver de backup para o dispositivo.

Um chamador também pode chamar DiRollbackDriver para fazer o seguinte:

  • Suprime a exibição de qualquer componente de interface do usuário associado à reversão do driver.

  • Indique ao chamador se uma reinicialização do sistema é necessária para concluir a instalação.

Para obter mais informações sobre a reversão do pacote de driver, consulte informações sobre Gerenciador de Dispositivos no Centro de Ajuda e Suporte.

UpdateDriverForPlugAndPlayDevices

A função UpdateDriverForPlugAndPlayDevices instala o pacote de driver em todos os dispositivos presentes no sistema que têm uma ID de hardware ou ID compatível que corresponde ao pacote de driver.

Chamar essa função ou DiInstallDriver é a maneira mais simples de um aplicativo de instalação instalar um novo pacote de driver que é a melhor correspondência para dispositivos no sistema. A operação básica de UpdateDriverForPlugAndPlayDevices é semelhante à operação de DiInstallDriver. No entanto , UpdateDriverForPlugAndPlayDevices dá suporte a opções de instalação adicionais.

Por padrão, UpdateDriverForPlugAndPlayDevices só instalará o pacote de driver em um dispositivo se o pacote de driver for uma correspondência melhor ao dispositivo do que o pacote de driver instalado atualmente em um dispositivo.

Opcionalmente, um chamador pode chamar UpdateDriverForPlugAndPlayDevices para fazer o seguinte:

  • Force a instalação do pacote de driver especificado, independentemente de o pacote de driver ser uma correspondência melhor para o dispositivo do que o pacote de driver instalado no momento no dispositivo.

    Cuidado Forçar a instalação do pacote de driver pode resultar na substituição de um pacote de driver mais compatível ou mais recente por um pacote de driver menos compatível ou mais antigo.

  • Suprimir copiar, renomear ou excluir arquivos de instalação.

  • Suprime a exibição de componentes da interface do usuário.

  • Indique ao chamador se uma reinicialização do sistema é necessária para concluir a instalação.