структура 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
Указывает версию операционной системы, для которой был написан драйвер.
| Ценность | Операционная система |
|---|---|
| 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\0").
Замечания
При вызове DrvUpgradePrinter со своим параметром pDriverUpgradeInfo, указывающим на структуру DRIVER_UPGRADE_INFO_2, элемент pPrinterName указывает на строку, содержащую имя принтера, которую необходимо обновить. Элемент pName указывает на строку, содержащую имя драйвера принтера, который не обязательно является драйвером принтера, имя которого указывает на элемент pPrinterName.
Чтобы узнать, как это может произойти, предположим, что компьютер подключен к двум принтерам, один драйвер которого называется Acme Plotter и другой драйвер которого называется Acme RasterMaster. Предположим, что оба драйвера совместно используют общий файл драйвера, plotui.dll. Когда драйвер Acme Plotter обновляется вызовом функции AddPrinterDriverEx (описано в документации по пакету SDK Для Microsoft Windows), DrvUpgradePrinter вызывается для обоих принтеров, так как оба драйвера используют файлы, затронутые обновлением. В обоих вызовах элемент pName указывает на "Acme Plotter", имя драйвера принтера, используемого в вызове AddPrinterDriverEx. Строка, на которую указывает элемент pPrinterName, отличается в обоих вызовах DrvUpgradePrinter, однако. В каждом вызове pPrinterName указывает на имя обновляемого принтера.
Требования
| Требование | Ценность |
|---|---|
| заголовка | winddiui.h (include Winddiui.h) |