共用方式為


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。 當呼叫 AddPrinterDriverEx 函式來更新 “Acme Plotter” 驅動程式時(如 Microsoft Windows SDK 檔所述),DrvUpgradePrinter 會針對這兩部印表機呼叫 DrvUpgradePrinter,因為這兩個驅動程式都會使用受到升級影響的檔案。 在這兩個呼叫中,pName 成員指向 “Acme Plotter”,這是呼叫中用來 AddPrinterDriverEx的印表機驅動程序名稱。 不過,在呼叫DrvUpgradePrinter時,pPrinterName 成員所指向的字串不同。 在每個呼叫中,pPrinterName 指向要更新的印表機名稱。

要求

要求 價值
標頭 winddiui.h (包括 Winddiui.h)

另請參閱

DRIVER_UPGRADE_INFO_1

DrvUpgradePrinter