Usando funções de instalação de dispositivo

Esta seção resume as funções de instalação do dispositivo . Usando as funções de instalação do dispositivo, o software de instalação pode executar os seguintes tipos de operações:

• Instalar controladores

• Manipule códigos DIF.

• Gerencie conjuntos de informações do dispositivo.

• Gerencie listas de drivers.

• Gerencie interfaces de dispositivos.

• Gerencie ícones e outros bitmaps.

As tabelas a seguir fornecem resumos dos seguintes tipos de funções:

Funções de instalação do driver

Funções de informação do dispositivo

Funções de informação do condutor

Manipuladores de Instalação de Dispositivos

Funções de personalização de instalação de dispositivo

Funções de configuração da classe

Funções de Bitmap e Ícone

Funções de interface do dispositivo

Funções de Propriedades de Dispositivos (Windows Vista e posterior)

Funções do Registro

Outras funções

Funções de instalação do driver

DiInstallDevice	Instala um pacote de driver especificado que está pré-instalado no armazenamento de driver num dispositivo PnP presente no sistema. (Windows Vista e versões posteriores do Windows)
DiUninstallDevice	Desinstala um dispositivo e remove seu nó de dispositivo (devnode) do sistema. (Windows 7 e versões posteriores do Windows)
DiInstallDriver	Pré-instala um pacote de driver no armazenamento de driver e, em seguida, instala o pacote de driver em dispositivos PnP correspondentes que estão presentes no sistema. (Windows Vista e versões posteriores do Windows)
DiUninstallDriver	Remove um pacote de driver do Driver Store. (Windows 10 Versão 1703 e versões posteriores do Windows)
AtualizarDriverParaDispositivosPlugAndPlay	Atualiza o pacote de driver instalado para dispositivos PnP correspondentes que estão presentes no sistema.
DiRollbackDriver	Reverte o pacote de driver instalado em um dispositivo especificado para o pacote de driver de backup definido para o dispositivo. (Windows Vista e versões posteriores do Windows)

Funções de Informação do Dispositivo

Nota

SetupApi não é suportado em todas as edições do Windows. Sempre que possível, você deve usar APIs de camada inferior, como as disponíveis via CfgMgr32.dll. Consulte Migração de SetupApi para CfgMgr32 para obter dicas.

SetupDiCreateDeviceInfoList - Função para Configuração de Lista de Informações do Dispositivo	Cria um conjunto vazio de informações do dispositivo . Esse conjunto pode ser associado a um GUID de classe.
SetupDiCreateDeviceInfoListEx	Cria um conjunto de informações de dispositivo vazio. Este conjunto pode ser associado a um GUID de classe e pode ser para dispositivos num computador remoto.
SetupDiCreateDeviceInfo	Cria um novo elemento de informações do dispositivo e o adiciona como um novo membro ao conjunto de informações do dispositivo especificado.
SetupDiOpenDeviceInfo	Recupera informações sobre uma instância de dispositivo existente e as adiciona ao conjunto de informações do dispositivo especificado.
SetupDiEnumDeviceInfo	Retorna uma estrutura de contexto para um elemento de informações de dispositivo de um conjunto de informações de dispositivo.
SetupDiGetDeviceInstanceId	Recupera o ID da instância do dispositivo associado a um elemento de informações do dispositivo.
SetupDiGetDeviceInfoListClass	Recupera o GUID de classe associado a um conjunto de informações de dispositivo se ele tiver uma classe associada.
SetupDiGetDeviceInfoListDetail	Recupera informações associadas a um conjunto de informações do dispositivo, incluindo o GUID da classe, o identificador do computador remoto e o nome do computador remoto.
SetupDiGetClassDevPropertySheets	Recupera identificadores para as folhas de propriedades de um elemento de informações de dispositivo especificado ou da classe de configuração de dispositivo de um conjunto de informações de dispositivo especificado.
SetupDiGetClassDevs	Retorna um conjunto de informações do dispositivo que contém todos os dispositivos de uma classe especificada.
SetupDiGetClassDevsEx	Retorna um conjunto de informações de dispositivo que contém todos os dispositivos de uma classe especificada em um computador local ou remoto.
SetupDiSetSelectedDevice	Define o elemento de informações do dispositivo especificado como o membro selecionado atualmente de um conjunto de informações do dispositivo. Esta função é normalmente usada por um assistente de instalação.
SetupDiGetSelectedDevice	Recupera o dispositivo atualmente selecionado para o conjunto especificado de informações do dispositivo.
SetupDiRegisterDeviceInfo	Registra uma instância de dispositivo recém-criada com o gerenciador Plug and Play.
SetupDiDeleteDeviceInfo	Exclui um membro do conjunto de informações do dispositivo especificado. Esta função não exclui o dispositivo real.
SetupDiDestroyDeviceInfoList	Destrói um conjunto de informações do dispositivo e libera toda a memória associada.

Funções de Informação do Condutor

SetupDiBuildDriverInfoList	Cria uma lista de drivers associados a uma instância de dispositivo especificada ou à lista de drivers de classe global do conjunto de informações do dispositivo.
SetupDiEnumDriverInfo	Enumera os membros de uma lista de informações de driver.
SetupDiGetDriverInfoDetail	Recupera informações detalhadas para um elemento de informação do controlador especificado.
SetupDiSetSelectedDriver	Define o membro especificado de uma lista de controladores como o controlador selecionado no momento. Ele também pode ser usado para redefinir a lista de drivers para que não haja nenhum driver selecionado atualmente.
SetupDiGetSelectedDriver	Recupera o elemento de uma lista de drivers que foi selecionado para instalação.
SetupDiCancelDriverInfoSearch	Cancela uma pesquisa de lista de drivers que está atualmente em andamento em um thread diferente.
SetupDiDestroyDriverInfoList	Destrói uma lista de informações do motorista.

Manipuladores de instalação de dispositivos

SetupDiCallClassInstaller	Chama o instalador de classe apropriado e quaisquer coinstaladores registrados, com a solicitação de instalação especificada.
SetupDiChangeState	O manipulador padrão para a solicitação DIF_PROPERTYCHANGE. Ele pode ser usado para alterar o estado de um dispositivo instalado.
SetupDiRegisterCoDeviceInstallers	Registra os coinstaladores específicos do dispositivo listados no arquivo INF para o dispositivo especificado. Esta função é o manipulador padrão para DIF_REGISTER_COINSTALLERS.
SetupDiInstallDevice	O manipulador padrão para a solicitação de DIF_INSTALLDEVICE.
SetupDiInstallDriverFiles	O manipulador padrão para a solicitação DIF_INSTALLDEVICEFILES.
SetupDiInstallDeviceInterfaces	O manipulador padrão para a solicitação DIF_INSTALLINTERFACES. Ele instala as interfaces listadas em um DDInstall.seção Interfaces de um arquivo INF de dispositivo.
SetupDiMoveDuplicateDevice	Esta função está obsoleta e não pode ser usada em nenhuma versão do Microsoft Windows.
SetupDiRemoveDevice	O manipulador padrão para a solicitação DIF_REMOVEDEVICE.
SetupDiUnremoveDevice	O manipulador padrão para a solicitação DIF_UNREMOVE.
SetupDiRegisterDeviceInfo	O manipulador padrão para a solicitação DIF_REGISTERDEVICE.
SetupDiSelectDevice SetupDiSelectDevice	O manipulador padrão para a solicitação DIF_SELECTDEVICE.
SetupDiSelectBestCompatDrv	O manipulador padrão para a solicitação DIF_SELECTBESTCOMPATDRV.
SetupDiSelectDevice	Manipulador padrão para a solicitação DIF_SELECTDEVICE.

Personalização das Funções de Instalação de Dispositivo

SetupDiGetClassInstallParams	Recupera parâmetros de instalação de classe para um conjunto de informações de dispositivo ou um elemento de informações de dispositivo específico.
SetupDiSetClassInstallParams	Define ou limpa parâmetros de instalação de classe para um conjunto de informações de dispositivo ou um elemento de informações de dispositivo específico.
SetupDiGetDeviceInstallParams	Recupera parâmetros de instalação de dispositivo para um conjunto de informações de dispositivo ou um elemento de informações de dispositivo específico.
SetupDiSetDeviceInstallParams	Define parâmetros de instalação de dispositivo para um conjunto de informações de dispositivo ou um elemento de informações de dispositivo específico.
SetupDiGetDriverInstallParams	Recupera parâmetros de instalação para o driver especificado.
SetupDiSetDriverInstallParams	Define os parâmetros de instalação para o driver especificado.

Configurar Funções de Classe

SetupDiBuildClassInfoList	Retorna uma lista de GUIDs de classe de instalação que inclui todas as classes instaladas no sistema.
SetupDiBuildClassInfoListEx	Retorna uma lista de GUIDs de classe de instalação que inclui todas as classes instaladas no sistema local ou em um sistema remoto.
SetupDiGetClassDescription	Recupera a descrição da classe associada ao GUID da classe de instalação especificada.
SetupDiGetClassDescriptionEx	Recupera a descrição de uma classe de instalação instalada em um computador local ou remoto.
SetupDiGetINFClass	Recupera a classe de um arquivo INF de dispositivo especificado.
SetupDiClassGuidsFromName	Recupera os GUIDs associados ao nome da classe especificada. Esta lista é construída com base em quais classes estão atualmente instaladas no sistema.
SetupDiClassGuidsFromNameEx	Recupera os GUIDs associados ao nome da classe especificada. Esta lista resultante contém as classes atualmente instaladas em um computador local ou remoto.
SetupDiClassNameFromGuid	Recupera o nome da classe associado ao GUID da classe.
SetupDiClassNameFromGuidEx	Recupera o nome da classe associado a um GUID de classe. A classe pode ser instalada em um computador local ou remoto.
SetupDiInstallClass	Instala a seção ClassInstall32 do arquivo INF especificado.
SetupDiInstallClassEx	Instala um instalador de classe ou uma classe de interface.
SetupDiOpenClassRegKey	Abre a chave do Registro da classe de configuração do dispositivo , ou uma subchave específica da classe.
SetupDiOpenClassRegKeyEx	Abre a chave do Registro da classe de configuração do dispositivo, a chave do Registro da classe da interface do dispositivo ou uma subchave específica da classe. Esta função abre a chave especificada no computador local ou num computador remoto.

Funções de Bitmap e Ícone

SetupDiGetClassImageList	Cria uma lista de imagens que contém bitmaps para cada classe instalada e retorna a lista em uma estrutura de dados.
SetupDiGetClassImageListEx	Cria uma lista de imagens de bitmaps para cada classe instalada em um computador local ou remoto.
SetupDiGetClassImageIndex	Recupera o índice dentro da lista de imagens de classe de uma classe especificada.
SetupDiGetClassBitmapIndex	Recupera o índice do miniícone fornecido para a classe especificada.
SetupDiDrawMiniIcon	Desenha o miniícone especificado no local solicitado.
SetupDiLoadClassIcon	Carrega o ícone grande e o miniícone para a classe especificada.
SetupDiLoadDeviceIcon	Carrega um ícone de dispositivo para um dispositivo especificado. (Windows Vista e versões posteriores do Windows)
SetupDiDestroyClassImageList	Destrói uma lista de imagens de classe.

Interface de Funções do Dispositivo

Nota

SetupApi não é suportado em todas as edições do Windows. Sempre que possível, você deve usar APIs de camada inferior, como as disponíveis via CfgMgr32.dll. Consulte Portabilidade de SetupApi para CfgMgr32 para obter dicas.

SetupDiCreateDeviceInterface	Registra a funcionalidade do dispositivo (uma interface de dispositivo) para um dispositivo.
SetupDiOpenDeviceInterface	Recupera informações sobre uma interface de dispositivo existente e as adiciona ao conjunto de informações do dispositivo especificado.
SetupDiGetDeviceInterfaceAlias	Retorna um alias da interface do dispositivo especificado.
SetupDiGetClassDevs	Retorna um conjunto de informações do dispositivo que contém todos os dispositivos de uma classe especificada.
SetupDiGetClassDevsEx	Retorna um conjunto de informações de dispositivo que contém todos os dispositivos de uma classe especificada em um computador local ou remoto.
SetupDiEnumDeviceInterfaces	Retorna uma estrutura de contexto para um elemento de interface de dispositivo de um conjunto de informações de dispositivo. Cada chamada retorna informações sobre uma interface de dispositivo. A função pode ser chamada repetidamente para obter informações sobre várias interfaces expostas por um ou mais dispositivos.
SetupDiGetDeviceInterfaceDetail	Retorna detalhes sobre uma interface de dispositivo específica.
SetupDiCreateDeviceInterfaceRegKey	Cria uma subchave do Registro para armazenar informações sobre uma instância de interface de dispositivo e retorna um identificador para a chave.
SetupDiOpenDeviceInterfaceRegKey	Abre a subchave do Registro usada por aplicativos e drivers para armazenar informações específicas de uma instância de interface de dispositivo e retorna um identificador para a chave.
SetupDiDeleteDeviceInterfaceRegKey	Exclui a subchave do Registro que foi usada por aplicativos e drivers para armazenar informações específicas de uma instância de interface de dispositivo.
SetupDiInstallDeviceInterfaces	É o manipulador padrão para a solicitação DIF_INSTALLINTERFACES. Ele instala as interfaces listadas em um DDInstall.seção Interfaces de um arquivo INF de dispositivo.
SetupDiRemoveDeviceInterface	Remove uma interface de dispositivo registrada do sistema.
SetupDiDeleteDeviceInterfaceData	Exclui uma interface de dispositivo de um conjunto de informações de dispositivo.
SetupDiSetDeviceInterfaceDefault	Define uma interface de dispositivo especificada como a interface padrão para uma classe de dispositivo.
SetupDiInstallClassEx	Instala um instalador de classe ou uma classe de interface.
SetupDiOpenClassRegKeyEx	Abre a chave de registo da classe de configuração do dispositivo , a chave de registo da classe de interface do dispositivo ou uma subchave específica da classe. Esta função abre a chave especificada no computador local ou num computador remoto.

Funções de Propriedade do Dispositivo (Windows Vista e posteriores)

Nota

SetupApi não é suportado em todas as edições do Windows. Sempre que possível, você deve usar APIs de camada inferior, como as disponíveis via CfgMgr32.dll. Consulte Portabilidade de SetupApi para CfgMgr32 para obter dicas.

SetupDiGetClassProperty	Recupera uma propriedade de dispositivo definida para uma classe de configuração de dispositivo ou uma classe de interface de dispositivo.
SetupDiGetClassPropertyEx	Recupera uma propriedade de classe para uma classe de configuração de dispositivo ou uma classe de interface de dispositivo em um computador local ou remoto.
SetupDiGetClassPropertyKeys	Recupera uma matriz das chaves de propriedade do dispositivo que representam as propriedades do dispositivo definidas para uma classe de configuração de dispositivo ou uma classe de interface de dispositivo.
SetupDiGetClassPropertyKeysEx	Recupera uma matriz das chaves de propriedade do dispositivo que representam as propriedades do dispositivo definidas para uma classe de configuração de dispositivo ou uma classe de interface de dispositivo em um computador local ou remoto.
SetupDiGetDeviceInterfaceProperty	Recupera uma propriedade de dispositivo definida para uma interface de dispositivo.
SetupDiGetDeviceInterfacePropertyKeys	Recupera uma matriz de chaves de propriedade do dispositivo que representam as propriedades do dispositivo definidas para uma interface do dispositivo.
SetupDiGetDeviceProperty	Recupera uma propriedade de instância de dispositivo.
SetupDiGetDevicePropertyKeys	Recupera uma matriz das chaves de propriedade do dispositivo que representam as propriedades do dispositivo definidas para uma instância do dispositivo.
SetupDiSetClassProperty	Define uma propriedade de classe para uma classe de configuração de dispositivo ou uma classe de interface de dispositivo.
SetupDiSetClassPropertyEx	Define uma propriedade de dispositivo para uma classe de configuração de dispositivo ou uma classe de interface de dispositivo em um computador local ou remoto.
SetupDiSetDeviceInterfaceProperty	Define uma propriedade de dispositivo de uma interface de dispositivo.
SetupDiSetDeviceProperty	Define uma propriedade de instância de dispositivo.

Funções do Registro

Nota

SetupApi não é suportado em todas as edições do Windows. Sempre que possível, você deve usar APIs de camada inferior, como as disponíveis via CfgMgr32.dll. Consulte Porting de SetupApi para CfgMgr32 para obter dicas.

SetupDiCreateDevRegKey	Cria uma chave de armazenamento no registro para informações de configuração específicas do dispositivo e retorna um identificador para a chave.
SetupDiOpenDevRegKey	Abre uma chave de armazenamento do Registro para informações de configuração específicas do dispositivo e retorna um identificador para a chave.
SetupDiDeleteDevRegKey	Exclui a(s) chave(s) do Registro acessível pelo usuário especificada(s) associada(s) a um elemento de informações do dispositivo.
SetupDiOpenClassRegKey	Abre a chave do Registro da classe de instalação ou uma subchave específica da classe.
SetupDiOpenClassRegKeyEx	Abre a chave do Registro da classe de configuração do dispositivo, a chave do Registro da classe da interface do dispositivo ou uma subchave específica da classe. Esta função abre a chave especificada no computador local ou num computador remoto.
SetupDiCreateDeviceInterfaceRegKey	Cria uma subchave de registro não volátil para armazenar informações sobre uma instância de interface de dispositivo e retorna um identificador para a chave.
SetupDiOpenDeviceInterfaceRegKey	Abre a subchave do Registro usada por aplicativos e drivers para armazenar informações específicas de uma instância de interface de dispositivo e retorna um identificador para a chave.
SetupDiDeleteDeviceInterfaceRegKey	Exclui a subchave do Registro que foi usada por aplicativos e drivers para armazenar informações específicas de uma instância de interface de dispositivo.
SetupDiSetDeviceRegistryProperty	Define a propriedade de dispositivo Plug and Play especificada.
SetupDiGetDeviceRegistryProperty	Recupera a propriedade de dispositivo Plug and Play especificada.
SetupDiGetClassRegistryProperty	Recupera uma propriedade de classe de dispositivo especificada do Registro.
SetupDiSetClassRegistryProperty	Define uma propriedade de classe de dispositivo especificada no Registro.

Outras Funções

SetupDiGetActualModelsSection	Recupera a seção "Modelos INF" decorada adequada para ser utilizada ao instalar um dispositivo a partir de um ficheiro INF de dispositivo.
SetupDiGetActualSectionToInstall	Recupera a seção DDInstall apropriada a ser usada ao instalar um dispositivo a partir de um arquivo INF de dispositivo.
SetupDiGetActualSectionToInstallEx	Recupera o nome da seção INF DDInstall que instala um dispositivo para um sistema operacional especificado e arquitetura de processador.
SetupDiGetHwProfileFriendlyName	Recupera o nome amigável associado a um ID de perfil de hardware.
SetupDiGetHwProfileFriendlyNameEx	Recupera o nome amigável associado a um ID de perfil de hardware em um computador local ou remoto.
SetupDiGetHwProfileList	Recupera uma lista de todos os IDs de perfil de hardware definidos atualmente.
SetupDiGetHwProfileListEx	Recupera uma lista de todas as IDs de perfil de hardware definidas atualmente em um computador local ou remoto.
SetupDiRestartDevices	Reinicia um dispositivo especificado ou, se necessário, ativa todos os dispositivos que são operados pela mesma função e pelos mesmos drivers de filtro que o dispositivo especificado.