SP_DRVINSTALL_PARAMS structure (setupapi.h)

Une structure SP_DRVINSTALL_PARAMS contient des paramètres d’installation de pilote associés à un élément d’informations de pilote particulier.

Syntaxe

typedef struct _SP_DRVINSTALL_PARAMS {
  DWORD     cbSize;
  DWORD     Rank;
  DWORD     Flags;
  DWORD_PTR PrivateData;
  DWORD     Reserved;
} SP_DRVINSTALL_PARAMS, *PSP_DRVINSTALL_PARAMS;

Membres

cbSize

Taille, en octets, de la structure SP_DRVINSTALL_PARAMS.

Rank

Correspondance de classement de ce pilote. Va de 0 à n, où 0 est le plus compatible.

Flags

Indicateurs qui contrôlent les fonctions fonctionnant sur ce pilote. Il peut s’agir d’une combinaison des éléments suivants :

DNF_ALWAYSEXCLUDEFROMLIST (Windows Vista et versions ultérieures de Windows)

S’il est défini, cet indicateur empêche l’énumération du nœud du pilote , quel que soit le client qui effectue l’énumération.

DNF_AUTHENTICODE_SIGNED (Windows Server 2003 et versions ultérieures de Windows)

Le fichier INF de ce pilote est signé par une signature Authenticode. Cet indicateur est en lecture seule pour les programmes d’installation.

Pour plus d’informations, consultez Utilisation de SetupAPI pour vérifier les signatures d’authentification du pilote.

DNF_BAD_DRIVER

N’utilisez pas ce pilote. Les programmes d’installation peuvent lire et écrire cet indicateur.

Si cet indicateur est défini, SetupDiSelectBestCompatDrv et SetupDiSelectDevice ignorent ce pilote.

Un programme d’installation ou un co-programme d’installation de classe peut définir cet indicateur pour empêcher Windows de répertorier le pilote dans la boîte de dialogue Sélectionner un pilote. Un programme d’installation peut définir cet indicateur lorsqu’il gère une demande DIF_SELECTDEVICE ou DIF_SELECTBESTCOMPATDRV , par exemple.

DNF_BASIC_DRIVER (Windows XP et versions ultérieures de Windows)

Ce pilote est un pilote de base. Cet indicateur est en lecture seule pour les programmes d’installation.

DNF_CLASS_DRIVER

Ce pilote est un pilote de classe. Cet indicateur est en lecture seule pour les programmes d’installation.

DNF_COMPATIBLE_DRIVER

Ce pilote est un pilote compatible. Cet indicateur est en lecture seule pour les programmes d’installation.

DNF_DUPDESC

D’autres fournisseurs fournissent des pilotes qui ont la même description que ce pilote. Cet indicateur est en lecture seule pour les programmes d’installation.

DNF_DUPDRIVERVER (Windows XP et versions ultérieures de Windows)

D’autres fournisseurs fournissent des pilotes qui ont la même version que ce pilote. Cet indicateur est en lecture seule pour les programmes d’installation.

DNF_DUPPROVIDER

D’autres fournisseurs fournissent des pilotes qui ont la même description que ce pilote. La seule différence entre ce pilote et sa correspondance est la date du pilote. Cet indicateur est en lecture seule pour les programmes d’installation.

Si cet indicateur est défini, Windows affiche la date et la version du pilote en regard du pilote afin que l’utilisateur puisse la distinguer de sa correspondance.

DNF_EXCLUDEFROMLIST

N’affichez pas ce pilote dans les boîtes de dialogue de sélection du pilote.

DNF_INBOX_DRIVER (Windows Vista et versions ultérieures de Windows)

Ce nœud de pilote est dérivé d’un fichier INF qui a été inclus avec cette version de Windows.

DNF_INET_DRIVER

Ce pilote provient d’Internet ou de Windows Update. Cet indicateur est en lecture seule pour les programmes d’installation.

Si vous appelez SetupCopyOEMInf, vous devez spécifier l’indicateur SPOST_URL afin que lorsque Windows copie cet INF dans le répertoireinf %SystemRoot%\, Windows le marque comme inf Internet. Si vous omettez cette étape, Windows tentera d’utiliser cet appareil pour installer d’autres appareils. Le problème qui en résulte est que Windows n’a plus les fichiers sources et finit par inviter l’utilisateur avec un chemin d’accès non valide.

DNF_INF_IS_SIGNED (Windows XP et versions ultérieures de Windows)

Cet indicateur est en lecture seule pour les programmes d’installation et est défini si l’une des conditions suivantes est remplie :

• Le pilote a une signature de mise en production WHQL.
• Le pilote est un pilote de boîte de réception.
• Le pilote a une signature Authenticode.

DNF_INSTALLEDDRIVER (Windows Vista et versions ultérieures de Windows)

Ce nœud de pilote est actuellement installé pour l’appareil. Cet indicateur est en lecture seule pour les programmes d’installation.

DNF_LEGACYINF

Ce pilote provient d’un fichier INF hérité. Cet indicateur est valide uniquement pour le système d’exploitation NT. Cet indicateur est en lecture seule pour les programmes d’installation.

DNF_NODRIVER

Définir si aucun pilote physique ne doit être installé pour ce pilote logique.

DNF_OEM_F6_INF (Windows XP et versions ultérieures de Windows)

Réservé.

DNF_OLD_INET_DRIVER

Ce pilote provient d’Internet, mais Windows n’a actuellement pas accès à ses fichiers sources. Cet indicateur est en lecture seule pour les programmes d’installation.

Le système n’installe pas de pilote marqué avec cet indicateur, car Windows n’a pas les fichiers sources et finit par inviter l’utilisateur avec un chemin d’accès non valide. L’INF d’un tel pilote peut être utilisé pour tout, à l’exception de l’installation des appareils.

DNF_OLDDRIVER

Ce pilote contrôlait actuellement/précédemment l’appareil associé. Cet indicateur est en lecture seule pour les programmes d’installation.

DNF_REQUESTADDITIONALSOFTWARE (Windows 7 et versions ultérieures de Windows)

Définissez cet indicateur si le package de pilotes fait uniquement partie de la solution logicielle nécessaire au fonctionnement de l’appareil. Dans ce cas, le package de pilotes nécessite l’installation de logiciels supplémentaires.

Pour plus d'informations, consultez la section Notes qui suit.

PrivateData

Champ qu’un programme d’installation de classe peut utiliser pour stocker des données privées. Les co-programmes d’installation ne doivent pas utiliser ce champ.

Reserved

Réservé. À usage interne uniquement.

Remarques

À compter de Windows 7, un programme d’installation ou un co-programme d’installation peut définir l’indicateur DNF_REQUESTADDITIONALSOFTWARE pour indiquer que le package de pilotes nécessite des logiciels supplémentaires qui peuvent ou non être installés sur l’ordinateur.

Une fois le package de pilotes de l’appareil installé, le gestionnaire de Plug-and-Play (PnP) effectue les étapes suivantes si le programme d’installation définit l’indicateur DNF_REQUESTADDITIONALSOFTWARE :

1. Le gestionnaire PnP génère un rapport d’erreurs de rapport de problème et de solution (PRS) avec le type RequestAddtionalSoftware. Ce rapport contient des informations sur l’ID matériel spécifique de l’appareil et l’architecture système de l’ordinateur.
2. S’il existe une solution fournie par le fournisseur de matériel indépendant (IHV) pour le logiciel spécifique à l’appareil, la solution est téléchargée sur l’ordinateur.
   Note Le téléchargement de la solution n’installe pas le logiciel lui-même.
    
3. Si le logiciel spécifique à l’appareil n’est pas installé sur l’ordinateur, le gestionnaire PnP présente la solution à l’utilisateur et fournit un lien pour télécharger le logiciel. L’utilisateur peut ensuite choisir de télécharger et d’installer ce logiciel en suivant les instructions présentées dans la solution.

Configuration requise

Voir aussi

SetupDiGetDriverInstallParams

SetupDiSetDriverInstallParams