Поделиться через

структура DRIVER_UPGRADE_INFO_2 (winddiui.h)

  • Статья

Структура DRIVER_UPGRADE_INFO_2 используется в качестве входных данных для функции DrvUpgradePrinter библиотеки DLL интерфейса принтера.

Синтаксис

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

Указывает версию операционной системы, для которой был написан драйвер.

Значение Операционная система
0 Windows 95/98/Me
1 Windows NT с 3.1 по Windows NT 3.51
2 Windows NT 4.0
3 Windows 2000 и более поздних версий

pName

Указатель на строку с завершением NULL, указывающую имя драйвера (например, "QMS 810"). Дополнительные сведения см. в разделе «Примечания».

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

Указатель на строку, завершающуюся значением NULL, которая указывает языковой монитор (например, "Монитор PJL"). Этот элемент может иметь значение NULL и должен быть указан как не null только для принтеров, способных к двунаправленному обмену данными.

pDefaultDataType

Указатель на строку, завершающуюся значением NULL, которая указывает тип данных по умолчанию для задания печати (например, "EMF").

pszzPreviousNames

Указатель на строку, завершающуюся значением NULL, которая указывает все предыдущие имена драйверов принтера, совместимые с этим драйвером (например, "OldName1\0OldName2\0\0").

Комментарии

При вызове DrvUpgradePrinter с параметром pDriverUpgradeInfo , указывающим на DRIVER_UPGRADE_INFO_2 структуру, элемент pPrinterName указывает на строку, содержащую имя обновляемого принтера. Элемент pName указывает на строку, содержащую имя обновляемого драйвера принтера, который не обязательно является драйвером для принтера, на имя которого указывает элемент pPrinterName .

Чтобы увидеть, как это может произойти, предположим, что компьютер подключен к двум принтерам, один из которых называется "Acme Plotter", а другой драйвер называется "Acme RasterMaster". Предположим также, что оба драйвера совместно используют общий файл драйвера, plotui.dll. Когда драйвер Acme Plotter обновляется путем вызова функции AddPrinterDriverEx (описанной в документации по Microsoft Windows SDK), drvUpgradePrinter вызывается для обоих принтеров, так как оба драйвера используют файлы, затронутые обновлением. В обоих вызовах член pName указывает на "Acme Plotter", имя драйвера принтера, используемое в вызове AddPrinterDriverEx. Однако строка, на которую указывает элемент pPrinterName , отличается в обоих вызовах DrvUpgradePrinter. В каждом вызове pPrinterName указывает на имя обновляемого принтера.

Требования

Требование Значение
Заголовок winddiui.h (включая Winddiui.h)

См. также раздел

DRIVER_UPGRADE_INFO_1

DrvUpgradePrinter