DIF_ADDPROPERTYPAGE_ADVANCED
Une demande DIF_ADDPROPERTYPAGE_ADVANCED permet à un programme d’installation de fournir une ou plusieurs pages de propriétés personnalisées pour un appareil.
Date d’envoi
Lorsqu’un utilisateur clique sur les propriétés d’un appareil dans Gestionnaire de périphériques ou dans Panneau de configuration.
Qui gère
Co-programme d’installation de classe |
Peut gérer |
Co-programme d’installation d’appareil |
Peut gérer |
Programme d’installation de classe |
Peut gérer |
Entrée du programme d’installation
DeviceInfoSet
Fournit un handle au jeu d’informations de l’appareil qui contient l’appareil.
DeviceInfoData
Fournit éventuellement un pointeur vers une structure de SP_DEVINFO_DATA qui identifie l’appareil dans le jeu d’informations sur l’appareil. Si DeviceInfoSet a la valeur NULL, Windows demande des pages de propriétés pour la classe d’installation de l’appareil.
Paramètres d’installation de l’appareil
Les paramètres d’installation de l’appareil (SP_DEVINSTALL_PARAMS) sont associés à DeviceInfoData, s’ils sont spécifiés, ou à DeviceInfoSet.
Paramètres d’installation de classe
Une structure SP_ADDPROPERTYPAGE_DATA est associée à DeviceInfoData, si elle est spécifiée, ou à DeviceInfoSet.
Sortie du programme d’installation
Paramètres d’installation de l’appareil
Un programme d’installation peut modifier les paramètres d’installation de l’appareil.
Paramètres d’installation de classe
Un programme d’installation peut modifier le SP_ADDPROPERTYPAGE_DATA pour fournir des pages personnalisées.
Valeur de retour du programme d’installation
Un co-programme d’installation peut retourner NO_ERROR ou une erreur Win32. Un co-programme d’installation ne doit pas retourner ERROR_DI_POSTPROCESSING_REQUIRED pour cette demande DIF.
Un programme d’installation de classe retourne NO_ERROR s’il fournit correctement des pages. Sinon, un programme d’installation de classe retourne ERROR_DI_DO_DEFAULT ou un code d’erreur Win32.
Gestionnaire de code DIF par défaut
None
Opération du programme d’installation
En réponse à cette demande DIF, un programme d’installation peut fournir des pages de propriétés personnalisées. La gestion de cette demande DIF vous permet de fournir des pages de propriétés à partir d’un programme d’installation ou d’un co-programme d’installation de classe et supprime la nécessité d’une DLL distincte qui joue le rôle de fournisseur de pages de propriétés.
Un programme d’installation gère généralement cette demande DIF pour ajouter une nouvelle page de propriétés spécifique à l’appareil ou à la classe d’installation. Un programme d’installation peut également remplacer la page de propriétés de pilote fournie par le système, la page de propriétés de ressource ou la page de propriétés d’alimentation d’un appareil. Si un programme d’installation remplace une page fournie par le système, le programme d’installation doit définir l’indicateur approprié dans les paramètres d’installation de l’appareil pour l’appareil :
DI_DRIVERPAGE_ADDED
Le programme d’installation a fourni une page de propriétés de pilote.
DI_RESOURCEPAGE_ADDED
Le programme d’installation a fourni une page de propriétés de ressource.
DI_FLAGSEX_POWERPAGE_ADDED
Le programme d’installation a fourni une page de propriétés d’alimentation.
Un programme d’installation ne peut pas remplacer la page de propriétés générales fournie par le système.
Windows affiche uniquement une page de pilotes, une page de ressources et une page d’alimentation pour un appareil. Un programme d’installation ne doit pas fournir de page système de remplacement si un programme d’installation précédent a déjà fourni une page de ce type. Cette contrainte ne s’applique pas aux pages de propriétés non fournies par le système.
Un co-programme d’installation doit ajouter des pages personnalisées dans sa passe de prétraitement.
Si un programme d’installation permet à un utilisateur de définir une propriété qui exige que Windows supprime et redémarre l’appareil, le programme d’installation doit définir l’indicateur DI_FLAGSEX_PROPCHANGE_PENDING dans les paramètres d’installation de l’appareil à partir de sa routine DialogProc .
Pour plus d’informations sur la façon de fournir des pages de propriétés d’appareil, consultez Fournir des pages de propriétés d’appareil.
Pour plus d’informations sur les codes DIF, consultez Gestion des codes DIF.
Spécifications
Version |
Pris en charge dans Microsoft Windows 2000 et versions ultérieures de Windows. |
En-tête |
Setupapi.h (inclure Setupapi.h) |