structure DRIVER_UPGRADE_INFO_2 (winddiui.h)
La structure DRIVER_UPGRADE_INFO_2 est utilisée comme entrée dans la fonction DrvUpgradePrinter d’une DLL d’imprimante.
Syntaxe
typedef struct _DRIVER_UPGRADE_INFO_2 {
LPTSTR pPrinterName;
LPTSTR pOldDriverDirectory;
DWORD cVersion;
LPTSTR pName;
LPTSTR pEnvironment;
LPTSTR pDriverPath;
LPTSTR pDataFile;
LPTSTR pConfigFile;
LPTSTR pHelpFile;
LPTSTR pDependentFiles;
LPTSTR pMonitorName;
LPTSTR pDefaultDataType;
LPTSTR pszzPreviousNames;
} DRIVER_UPGRADE_INFO_2, *PDRIVER_UPGRADE_INFO_2;
Membres
pPrinterName
Pointeur vers une chaîne terminée par NULL qui spécifie le nom de l’imprimante. Pour plus d'informations, consultez la section Notes.
pOldDriverDirectory
Pointeur vers une chaîne terminée par null qui spécifie le répertoire local dans lequel les anciens fichiers de pilote d’imprimante se trouvent.
cVersion
Spécifie la version du système d’exploitation pour laquelle le pilote a été écrit.
| Valeur | Système d'exploitation |
|---|---|
| 0 | Windows 95/98/Me |
| 1 | Windows NT 3.1 à Windows NT 3.51 |
| 2 | Windows NT 4.0 |
| 3 | Windows 2000 et versions ultérieures |
pName
Pointeur vers une chaîne terminée par null qui spécifie le nom du pilote (par exemple, « QMS 810 »). Pour plus d'informations, consultez la section Notes.
pEnvironment
Pointeur vers une chaîne terminée par null qui spécifie l’environnement pour lequel le pilote a été écrit (par exemple, « Windows NT x86 » ou « Windows Itanium »).
pDriverPath
Pointeur vers une chaîne terminée par null qui spécifie un nom de fichier ou un chemin d’accès complet et un nom de fichier pour le fichier qui contient le pilote de périphérique (par exemple, « pscript.dll »).
pDataFile
Pointeur vers une chaîne terminée par null qui spécifie un nom de fichier ou un chemin d’accès complet et un nom de fichier pour le fichier qui contient des données de pilote (par exemple, « qms810.ppd »).
pConfigFile
Pointeur vers une chaîne terminée par NULL qui spécifie un nom de fichier ou un chemin d’accès complet et un nom de fichier pour la bibliothèque de liens dynamiques de configuration du pilote de périphérique (par exemple, « pscrptui.dll »).
pHelpFile
Pointeur vers une chaîne terminée par null qui spécifie un nom de fichier ou un chemin d’accès complet et un nom de fichier pour le fichier d’aide du pilote de périphérique.
pDependentFiles
Pointeur vers une chaîne terminée par null qui spécifie les fichiers dont dépend le pilote. Chaque nom de fichier de la chaîne est également terminé par un caractère null (par exemple, « pscript.dll\0qms810.ppd\0pscrptui.dll\0pscrptui.hlp\0pstest.txt\0\0 »).
pMonitorName
Pointeur vers une chaîne terminée par null qui spécifie un moniteur de langage (par exemple, « moniteur PJL »). Ce membre peut être NULL et doit être spécifié comme non NULL uniquement pour les imprimantes capables de communication bidirectionnelle.
pDefaultDataType
Pointeur vers une chaîne terminée par NULL qui spécifie le type de données par défaut du travail d’impression (par exemple, « EMF »).
pszzPreviousNames
Pointeur vers une chaîne terminée par null qui spécifie tous les noms de pilotes d’imprimante précédents compatibles avec ce pilote (par exemple, « OldName1\0OldName2\0\0 »).
Remarques
Lorsque DrvUpgradePrinter est appelé avec son paramètre pDriverUpgradeInfo pointant vers une structure DRIVER_UPGRADE_INFO_2, le membre pPrinterName pointe vers une chaîne contenant le nom de l’imprimante à mettre à jour. Le membre pName pointe vers une chaîne contenant le nom du pilote d’imprimante à mettre à jour, qui n’est pas nécessairement le pilote de l’imprimante dont le nom est pointé par le membre pPrinterName .
Pour voir comment cela peut se produire, supposons qu’un ordinateur soit connecté à deux imprimantes, l’une dont le pilote est nommé « Acme Plotter » et l’autre dont le pilote est nommé « Acme RasterMaster ». Supposons également que les deux pilotes partagent un fichier de pilote commun, plotui.dll. Lorsque le pilote « Acme Plotter » est mis à jour par un appel à la fonction AddPrinterDriverEx (décrite dans la documentation Microsoft Windows SDK), DrvUpgradePrinter est appelé pour les deux imprimantes, car les deux pilotes utilisent des fichiers affectés par la mise à niveau. Dans les deux appels, le membre pName pointe vers « Acme Plotter », le nom du pilote d’imprimante utilisé dans l’appel à AddPrinterDriverEx. Toutefois, la chaîne pointée par le membre pPrinterName est différente dans les deux appels à DrvUpgradePrinter. Dans chaque appel, pPrinterName pointe vers le nom de l’imprimante en cours de mise à jour.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | winddiui.h (inclure Winddiui.h) |