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

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 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 requer que pacotes de driver específicos de cada instância de dispositivo sejam instalados nas respectivas instâncias de 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 preinstalado que seja a melhor compatibilidade 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 na Loja 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ó 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 no momento no dispositivo. Para obter informações sobre como o Windows seleciona um pacote de driver para dispositivo, consulte Como o Windows seleciona drivers.

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

• Force a instalação do pacote de driver especificado, independentemente de o pacote de driver oferecer melhor compatibilidade com o dispositivo do que o pacote de driver atualmente instalado 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 instalado atualmente em um dispositivo pelo pacote de driver de backup instalado anteriormente que está 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 se 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:

• Suprima a exibição de qualquer componente de interface de 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 as informações sobre o 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 para um aplicativo de instalação instalar um novo pacote de driver que melhor corresponde aos dispositivos do sistema. A operação básica de UpdateDriverForPlugAndPlayDevices é semelhante à operação do 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 para o dispositivo do que o pacote de driver instalado atualmente em um dispositivo.

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

• Force a instalação do pacote de driver especificado, independentemente de o pacote de driver ser a melhor opção para o dispositivo em comparação com o pacote atualmente instalado 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 a cópia, renomeação ou exclusão de 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.