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”) 。

備註

呼叫DrvUpgradePrinter時，其 pDriverUpgradeInfo 參數指向DRIVER_UPGRADE_INFO_2結構時， pPrinterName 成員會指向包含要更新之印表機名稱的字串。 pName 成員指向包含要更新之印表機驅動程式名稱的字串，這不一定是 pPrinterName 成員所指向印表機名稱的驅動程式。

若要查看這種情況如何發生，假設計算機已連線到兩部列印機，其中一部驅動程式名為 “Acme Plotter”，另一部驅動程式名為 “Acme RasterMaster”。 假設這兩個驅動程序共用通用驅動程式檔案，plotui.dll。 當呼叫 AddPrinterDriverEx 函式更新 「Acme Plotter」 驅動程式時， (Microsoft Windows SDK 檔) 中所述，系統會針對這兩個印表機呼叫 DrvUpgradePrinter，因為這兩個驅動程式都會使用受到升級影響的檔案。 在這兩個呼叫中， pName 成員會指向 「Acme Plotter」，這是呼叫 AddPrinterDriverEx 時所使用的印表機驅動程式名稱。 不過， pPrinterName 成員所指向的字串在對DrvUpgradePrinter的呼叫中都不同。 在每個呼叫中， pPrinterName 會指向要更新的印表機名稱。

規格需求

需求	值
標頭	winddiui.h (包含Winddiui.h)

另請參閱

DRIVER_UPGRADE_INFO_1

DrvUpgradePrinter