DRIVER_UPGRADE_INFO_2 Struktur (winddiui.h)
Die DRIVER_UPGRADE_INFO_2 Struktur wird als Eingabe für die DrvUpgradePrinter--Funktion einer Druckerschnittstellen-DLL verwendet.
Syntax
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;
Angehörige
pPrinterName
Zeigen Sie auf eine MIT NULL beendete Zeichenfolge, die den Namen des Druckers angibt. Weitere Informationen finden Sie im Abschnitt "Hinweise".
pOldDriverDirectory
Zeigen Sie auf eine MIT NULL beendete Zeichenfolge, die das lokale Verzeichnis angibt, in dem die alten Druckertreiberdateien gefunden werden können.
cVersion
Gibt die Betriebssystemversion an, für die der Treiber geschrieben wurde.
| Wert | Betriebssystem |
|---|---|
| 0 | Windows 95/98/Me |
| 1 | Windows NT 3.1 bis Windows NT 3.51 |
| 2 | Windows NT 4.0 |
| 3 | Windows 2000 und höher |
pName
Zeigen Sie auf eine MIT NULL beendete Zeichenfolge, die den Namen des Treibers angibt (z. B. "QMS 810"). Weitere Informationen finden Sie im Abschnitt "Hinweise".
pEnvironment
Zeigen Sie auf eine MIT NULL beendete Zeichenfolge, die die Umgebung angibt, für die der Treiber geschrieben wurde (z. B. "Windows NT x86" oder "Windows Itanium").
pDriverPath
Zeigen Sie auf eine MIT NULL beendete Zeichenfolge, die einen Dateinamen oder vollständigen Pfad und Dateinamen für die Datei angibt, die den Gerätetreiber enthält (z. B. "pscript.dll").
pDataFile
Zeigen Sie auf eine MIT NULL beendete Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Datei angibt, die Treiberdaten enthält (z. B. "qms810.ppd").
pConfigFile
Zeigen Sie auf eine MIT NULL beendete Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Konfigurations-Dynamic Link Library des Gerätetreibers angibt (z. B. "pscrptui.dll").
pHelpFile
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Hilfedatei des Gerätetreibers angibt.
pDependentFiles
Zeiger auf eine MIT NULL beendete Zeichenfolge, die die Dateien angibt, von denen der Treiber abhängt. Jeder Dateiname in der Zeichenfolge wird auch mit einem Nullzeichen beendet (z. B. "pscript.dll\0qms810.ppd\0pscrptui.dll\0pscrptui.hlp\0pstest.txt\0\0").
pMonitorName
Zeiger auf eine MIT NULL beendete Zeichenfolge, die einen Sprachmonitor angibt (z. B. "PJL-Monitor"). Dieses Element kann NULL- sein und sollte nur für Drucker mit bidirektionaler Kommunikation alsNULL- angegeben werden.
pDefaultDataType
Zeiger auf eine MIT NULL beendete Zeichenfolge, die den Standarddatentyp des Druckauftrags angibt (z. B. "EMF").
pszzPreviousNames
Zeigen Sie auf eine MIT NULL beendete Zeichenfolge, die alle vorherigen Druckertreibernamen angibt, die mit diesem Treiber kompatibel sind (z. B. "OldName1\0OldName2\0\0").
Bemerkungen
Wenn DrvUpgradePrinter mit seinem pDriverUpgradeInfo Parameter aufgerufen wird, der auf eine DRIVER_UPGRADE_INFO_2 Struktur zeigt, zeigt das pPrinterName-Element auf eine Zeichenfolge, die den Namen des zu aktualisierenden Druckers enthält. Der pName Member verweist auf eine Zeichenfolge, die den Namen des zu aktualisierenden Druckertreibers enthält, was nicht unbedingt der Treiber für den Drucker ist, auf dessen Name durch das pPrinterName Member verwiesen wird.
Um zu sehen, wie dies geschehen kann, nehmen wir an, dass ein Computer mit zwei Druckern verbunden ist, deren Treiber "Acme Plotter" und der andere, dessen Treiber "Acme RasterMaster" heißt. Angenommen, beide Treiber teilen eine gemeinsame Treiberdatei, plotui.dll. Wenn der Treiber "Acme Plotter" durch einen Aufruf der AddPrinterDriverEx- funktion aktualisiert wird (in der Microsoft Windows SDK-Dokumentation beschrieben), wird DrvUpgradePrinter für beide Drucker aufgerufen, da beide Treiber Dateien verwenden, die von dem Upgrade betroffen sind. In beiden Aufrufen verweist der pName Member auf "Acme Plotter", den Namen des Druckertreibers, der im Aufruf von AddPrinterDriverExverwendet wird. Die Zeichenfolge, auf die das pPrinterName Member verweist, unterscheidet sich jedoch in beiden Aufrufen von DrvUpgradePrinter. In jedem Aufruf verweist pPrinterName auf den Namen des Druckers, der aktualisiert wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | winddiui.h (include Winddiui.h) |