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)

Voir aussi

DRIVER_UPGRADE_INFO_1

DrvUpgradePrinter