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

Um aplicativo de instalação pode usar as seguintes funções 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 que é pré-instalado no Driver Store em um dispositivo específico presente no sistema.

Um aplicativo de instalação só deve usar essa função se ambas as opções a seguir forem verdadeiras:

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

• A aplicação requer que os pacotes de driver específicos para cada 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:

• Procure um pacote de driver pré-instalado que seja a melhor combinação 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 Driver Store e, em seguida, instala o pacote de driver em todos os dispositivos presentes no sistema que têm um ID de hardware ou um 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 suporta opções de instalação adicionais.

Por padrão, DiInstallDriver só instala o pacote de driver em um dispositivo se o pacote de driver for uma melhor correspondência para o dispositivo do que o pacote de driver que está atualmente instalado 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:

• Força a instalação do pacote de controladores especificado, independentemente de o controlador ser um melhor ajuste para o dispositivo do que aquele que está atualmente instalado.

  Atenção 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 é necessário reiniciar o sistema para concluir a instalação.

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

A função DiRollbackDriver substitui o pacote de driver que está atualmente instalado em um dispositivo com o pacote de driver de backup instalado anteriormente que está definido para um dispositivo. Esta função é fornecida principalmente para restaurar um dispositivo para uma condição de trabalho se um dispositivo falhar após a atualização do pacote de driver para o dispositivo. Esta 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 para 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 define o pacote de driver como o driver de backup para o dispositivo.

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

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

• Indique ao chamador se é necessário reiniciar o sistema para concluir a instalação.

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

AtualizarControladorParaDispositivosPlugAndPlay

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

Chamar esta função ou DiInstallDriver é a forma mais simples para uma aplicação de instalação instalar um novo pacote de driver mais adequado para os dispositivos do sistema. A operação básica de UpdateDriverForPlugAndPlayDevices é semelhante à operação de DiInstallDriver. No entanto, UpdateDriverForPlugAndPlayDevices suporta opções de instalação adicionais.

Por padrão, UpdateDriverForPlugAndPlayDevices só instala o pacote de driver em um dispositivo se o pacote de driver for mais adequado ao dispositivo do que o pacote de driver atualmente instalado em um dispositivo.

Um chamador também pode, opcionalmente, chamar UpdateDriverForPlugAndPlayDevices para fazer o seguinte:

• Força a instalação do pacote de driver especificado, independentemente de o pacote de driver ser uma melhor combinação com o dispositivo do que o atualmente instalado.

  Atenção 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.

• Suprima a cópia, renomeação ou exclusão de arquivos de instalação.

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

• Indique ao chamador se é necessário reiniciar o sistema para concluir a instalação.