estrutura SP_DRVINSTALL_PARAMS (setupapi.h)
Uma estrutura SP_DRVINSTALL_PARAMS contém parâmetros de instalação de driver associados a um elemento de informações de driver específico.
Sintaxe
typedef struct _SP_DRVINSTALL_PARAMS {
DWORD cbSize;
DWORD Rank;
DWORD Flags;
DWORD_PTR PrivateData;
DWORD Reserved;
} SP_DRVINSTALL_PARAMS, *PSP_DRVINSTALL_PARAMS;
Membros
cbSize
O tamanho, em bytes, da estrutura SP_DRVINSTALL_PARAMS.
Rank
A correspondência de classificação deste driver. Varia de 0 a n, em que 0 é o mais compatível.
Flags
Sinalizadores que controlam funções que operam nesse driver. Pode ser uma combinação do seguinte:
DNF_ALWAYSEXCLUDEFROMLIST (Windows Vista e versões posteriores do Windows)
Se definido, esse sinalizador impedirá que o nó do driver seja enumerado, independentemente do cliente que está executando a enumeração.
DNF_AUTHENTICODE_SIGNED (Windows Server 2003 e versões posteriores do Windows)
O arquivo INF desse driver é assinado por uma assinatura authenticode. Esse sinalizador é somente leitura para instaladores.
Para obter mais informações, consulte Using SetupAPI to Verify Driver Authenticode Signatures (Usando SetupAPI para verificar assinaturas de autenticação de driver).
DNF_BAD_DRIVER
Não use este driver. Os instaladores podem ler e gravar esse sinalizador.
Se esse sinalizador estiver definido, SetupDiSelectBestCompatDrv e SetupDiSelectDevice ignorarão esse driver.
Um instalador de classe ou um co-instalador pode definir esse sinalizador para impedir que o Windows liste o driver na caixa de diálogo Selecionar Driver. Um instalador pode definir esse sinalizador quando manipula uma solicitação de DIF_SELECTDEVICE ou DIF_SELECTBESTCOMPATDRV , por exemplo.
DNF_BASIC_DRIVER (Windows XP e versões posteriores do Windows)
Este driver é um driver básico. Esse sinalizador é somente leitura para instaladores.
DNF_CLASS_DRIVER
Este driver é um driver de classe. Esse sinalizador é somente leitura para instaladores.
DNF_COMPATIBLE_DRIVER
Esse driver é um driver compatível. Esse sinalizador é somente leitura para instaladores.
DNF_DUPDESC
Há outros provedores que fornecem drivers que têm a mesma descrição que esse driver. Esse sinalizador é somente leitura para instaladores.
DNF_DUPDRIVERVER (Windows XP e versões posteriores do Windows)
Há outros provedores que fornecem drivers que têm a mesma versão que esse driver. Esse sinalizador é somente leitura para instaladores.
DNF_DUPPROVIDER
Há outros provedores que fornecem drivers que têm a mesma descrição que esse driver. A única diferença entre esse driver e sua correspondência é a data do driver. Esse sinalizador é somente leitura para instaladores.
Se esse sinalizador estiver definido, o Windows exibirá a data do driver e a versão do driver ao lado do driver para que o usuário possa distingui-lo de sua correspondência.
DNF_EXCLUDEFROMLIST
Não exiba esse driver em nenhuma caixa de diálogo de seleção de driver.
DNF_INBOX_DRIVER (Windows Vista e versões posteriores do Windows)
Esse nó de driver é derivado de um arquivo INF que foi incluído nesta versão do Windows.
DNF_INET_DRIVER
Este driver veio da Internet ou de Windows Update. Esse sinalizador é somente leitura para instaladores.
Se você chamar SetupCopyOEMInf, deverá especificar o sinalizador SPOST_URL para que, quando o Windows copiar esse INF para o diretórioinf %SystemRoot%\, o Windows o marque como um INF da Internet. Se você omitir essa etapa, o Windows tentará usar esse dispositivo para instalar outros dispositivos. O problema resultante é que o Windows não tem mais os arquivos de origem e acabará solicitando ao usuário um caminho inválido.
DNF_INF_IS_SIGNED (Windows XP e versões posteriores do Windows)
Esse sinalizador é somente leitura para instaladores e é definido se qualquer uma das seguintes condições for verdadeira:
- O driver tem uma assinatura de versão do WHQL.
- O driver é um driver de caixa de entrada.
- O driver tem uma assinatura Authenticode.
DNF_INSTALLEDDRIVER (Windows Vista e versões posteriores do Windows)
No momento , esse nó de driver está instalado para o dispositivo. Esse sinalizador é somente leitura para instaladores.
DNF_LEGACYINF
Esse driver vem de um arquivo INF herdado. Esse sinalizador é válido apenas para o sistema operacional baseado em NT. Esse sinalizador é somente leitura para instaladores.
DNF_NODRIVER
Defina se nenhum driver físico deve ser instalado para esse driver lógico.
DNF_OEM_F6_INF (Windows XP e versões posteriores do Windows)
Reservado.
DNF_OLD_INET_DRIVER
Esse driver veio da Internet, mas o Windows atualmente não tem acesso aos arquivos de origem. Esse sinalizador é somente leitura para instaladores.
O sistema não instalará um driver marcado com esse sinalizador porque o Windows não tem os arquivos de origem e acabaria solicitando ao usuário um caminho inválido. O INF para esse driver pode ser usado para tudo, exceto para instalar dispositivos.
DNF_OLDDRIVER
Esse driver atualmente/anteriormente controlava o dispositivo associado. Esse sinalizador é somente leitura para instaladores.
DNF_REQUESTADDITIONALSOFTWARE (Windows 7 e versões posteriores do Windows)
Defina esse sinalizador se o pacote de driver for apenas parte da solução de software necessária para operar o dispositivo. Nesse caso, o pacote de driver requer a instalação de software adicional.
Para obter mais informações, consulte a seção Comentários a seguir.
PrivateData
Um campo que um instalador de classe pode usar para armazenar dados privados. Os co-instaladores não devem usar esse campo.
Reserved
Reservado. Apenas para uso interno.
Comentários
A partir do Windows 7, um instalador ou co-instalador pode definir o sinalizador DNF_REQUESTADDITIONALSOFTWARE para indicar que o pacote de driver requer software adicional que pode ou não ser instalado no computador.
Depois que o pacote de driver do dispositivo for instalado, o gerenciador de Plug and Play (PnP) executará as seguintes etapas se o instalador definir o sinalizador DNF_REQUESTADDITIONALSOFTWARE:
- O gerenciador PnP gera um relatório de erros prs (relatório de problemas e solução) com o tipo de RequestAddtionalSoftware. Este relatório contém informações sobre a ID de hardware específica do dispositivo e a arquitetura do sistema do computador.
-
Se houver uma solução fornecida pelo IHV (fornecedor independente de hardware) para o software específico do dispositivo, a solução será baixada para o computador.
Nota O download da solução não instala o software em si.
- Se o software específico do dispositivo não estiver instalado no computador, o gerenciador PnP apresentará a solução ao usuário e fornecerá um link para baixar o software. Em seguida, o usuário pode optar por baixar e instalar esse software seguindo as instruções apresentadas na solução.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | setupapi.h (inclua Setupapi.h) |