DRIVER_UPGRADE_INFO_2结构（winddiui.h）

DRIVER_UPGRADE_INFO_2 结构用作打印机接口 DLL DrvUpgradePrinter 函数的输入。

语法

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;

成员

pPrinterName

指向指定打印机名称的 NULL 终止字符串的指针。 有关详细信息，请参阅“备注”部分。

pOldDriverDirectory

指向 NULL 终止的字符串的指针，该字符串指定可在其中找到旧打印机驱动程序文件的本地目录。

cVersion

指定为其写入驱动程序的作系统版本。

pName

指向指定驱动程序名称（例如“QMS 810”）的 NULL 终止字符串的指针。 有关详细信息，请参阅“备注”部分。

pEnvironment

指向 NULL 终止的字符串的指针，该字符串指定为其编写驱动程序的环境（例如，“Windows NT x86”或“Windows Itanium”）。

pDriverPath

指向以 NULL 结尾的字符串的指针，该字符串指定包含设备驱动程序的文件的文件名或完整路径和文件名（例如，“pscript.dll” ）。

pDataFile

指向 NULL 终止的字符串的指针，该字符串指定包含驱动程序数据的文件的文件名或完整路径和文件名（例如，“qms810.ppd”）。

pConfigFile

指向 NULL 终止的字符串的指针，该字符串指定设备驱动程序配置动态链接库的文件名或完整路径和文件名（例如，“pscrptui.dll” ）。

pHelpFile

指向以 null 结尾的字符串的指针，该字符串指定设备驱动程序帮助文件的文件名或完整路径和文件名。

pDependentFiles

指向指定驱动程序所依赖的文件的 NULL 终止字符串的指针。 字符串中的每个文件名也以 null 字符结尾（例如，“pscript.dll\0qms810.ppd\0pscrptui.dll\0pscrptui.hlp\0pstest.txt\0\0” ）。

pMonitorName

指向指定语言监视器（例如“PJL 监视器”）的 NULL 终止字符串的指针。 此成员可以 NULL，并且应仅针对能够双向通信的打印机指定为非NULL。

pDefaultDataType

指向指定打印作业的默认数据类型（例如“EMF”）的 NULL 终止字符串的指针。

pszzPreviousNames

指向 NULL 终止的字符串的指针，该字符串指定与此驱动程序兼容的任何以前的打印机驱动程序名称（例如，“OldName1\0OldName2\0\0\0”）。

言论

当使用指向 DRIVER_UPGRADE_INFO_2结构的 pDriverUpgradeInfo 参数调用 DrvUpgradePrinter 时，pPrinterName 成员指向包含要更新的打印机名称的字符串。 pName 成员指向包含要更新的打印机驱动程序名称的字符串，这不一定是 pPrinterName 成员指向其名称的打印机的驱动程序。

若要查看这种情况的发生方式，假设计算机连接到两台打印机，其中一台打印机的驱动程序名为“Acme Plotter”，另一台打印机的驱动程序名为“Acme RasterMaster”。 假设这两个驱动程序共享一个通用驱动程序文件，plotui.dll。 当调用 AddPrinterDriverEx 函数（如 Microsoft Windows SDK 文档中所述）更新“Acme Plotter”驱动程序时，DrvUpgradePrinter 将同时调用这两个打印机，因为两个驱动程序都使用受升级影响的文件。 在这两次调用中，pName 成员指向“Acme Plotter”，即调用 AddPrinterDriverEx中使用的打印机驱动程序的名称。 但是，pPrinterName 成员指向的字符串在对 DrvUpgradePrinter 的调用中都是不同的。 在每个调用中，pPrinterName 指向要更新的打印机的名称。

要求

另请参阅

DRIVER_UPGRADE_INFO_1

DrvUpgradePrinter