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;
Member
pPrinterName
Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Druckers angibt. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
pOldDriverDirectory
Zeiger auf eine 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
Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen des Treibers angibt (z. B. "QMS 810"). Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
pEnvironment
Zeiger auf eine NULL-beendete Zeichenfolge, die die Umgebung angibt, für die der Treiber geschrieben wurde (z. B. "Windows NT x86" oder "Windows Itanium").
pDriverPath
Zeiger auf eine NULL-beendete Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Datei angibt, die den Gerätetreiber enthält (z. B. "pscript.dll").
pDataFile
Zeiger auf eine 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
Zeiger auf eine NULL-endende Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Konfigurationsbibliothek für dynamische Verknüpfungen des Gerätetreibers angibt (z. B. "pscrptui.dll").
pHelpFile
Zeiger auf eine NULL-endende Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Hilfedatei des Gerätetreibers angibt.
pDependentFiles
Zeiger auf eine NULL-beendete Zeichenfolge, die die Dateien angibt, von denen der Treiber abhängt. Jeder Dateiname in der Zeichenfolge wird ebenfalls mit einem NULL-Zeichen beendet (z. B. "pscript.dll\0qms810.ppd\0pscrptui.dll\0pscrptui.hlp\0pstest.txt\0\0").
pMonitorName
Zeiger auf eine NULL-beendete Zeichenfolge, die einen Sprachmonitor angibt (z. B. "PJL-Monitor"). Dieser Member kann NULL sein und sollte nur für Drucker angegeben werden, die bidirektional kommunizieren können.
pDefaultDataType
Zeiger auf eine NULL-beendete Zeichenfolge, die den Standarddatentyp des Druckauftrags angibt (z. B. "EMF").
pszzPreviousNames
Zeiger auf eine NULL-beendete Zeichenfolge, die alle vorherigen Druckertreibernamen angibt, die mit diesem Treiber kompatibel sind (z. B. "OldName1\0OldName2\0\0").
Hinweise
Wenn DrvUpgradePrinter mit dem pDriverUpgradeInfo-Parameter aufgerufen wird, der auf eine DRIVER_UPGRADE_INFO_2-Struktur zeigt, zeigt der pPrinterName-Member auf eine Zeichenfolge, die den Namen des zu aktualisierenden Druckers enthält. Das pName-Element verweist auf eine Zeichenfolge, die den Namen des zu aktualisierenden Druckertreibers enthält. Dabei handelt es sich nicht unbedingt um den Treiber für den Drucker, auf dessen Name das pPrinterName-Element verweist.
Um zu sehen, wie dies geschehen kann, nehmen Sie an, dass ein Computer mit zwei Druckern verbunden ist, deren Treiber "Acme Plotter" heißt und der andere, dessen Treiber "Acme RasterMaster" heißt. Nehmen wir auch an, dass beide Treiber eine gemeinsame Treiberdatei plotui.dll. Wenn der Treiber "Acme Plotter" durch einen Aufruf der AddPrinterDriverEx-Funktion aktualisiert wird (beschrieben in der Microsoft Windows SDK-Dokumentation), wird DrvUpgradePrinter für beide Drucker aufgerufen, da beide Treiber Dateien verwenden, die vom Upgrade betroffen sind. In beiden Aufrufen zeigt das pName-Element auf "Acme Plotter", den Namen des Druckertreibers, der im Aufruf von AddPrinterDriverEx verwendet wurde. Die Zeichenfolge, auf die das pPrinterName-Element verweist, unterscheidet sich jedoch in beiden Aufrufen von DrvUpgradePrinter. Bei jedem Aufruf zeigt pPrinterName auf den Namen des Druckers, der aktualisiert wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | winddiui.h (einschließlich Winddiui.h) |