drvUpgradePrinter 函式 (winddiui.h)

  • 發行項

將新版本的驅動程式新增至系統時，會使用印表機介面 DLL 的 DrvUpgradePrinter函 式來更新印表機的登錄設定。

語法

BOOL DrvUpgradePrinter(
                 DWORD  Level,
  [in, optional] LPBYTE pDriverUpgradeInfo
);

參數

Level

呼叫端提供的值，指出 pDriverUpgradeInfo 所指向的結構類型，如下表所示。

層級 值 pDriverUpgradeInfo 所指向的結構
1 DRIVER_UPGRADE_INFO_1
2 DRIVER_UPGRADE_INFO_2

[in, optional] pDriverUpgradeInfo

呼叫端提供的結構指標，其類型是由 dwLevel 識別。

傳回值

如果作業成功，函式應該會傳回 TRUE;否則，它應該呼叫 SetLastError 來設定錯誤碼並傳回 FALSE。

備註

印表機介面 DLL 可以選擇性地提供DrvUpgradePrinter函式。 如果這樣做，多任務緩衝處理器會在印表機驅動程式複製到系統時，針對每一個印表機呼叫它。 當系統從某個作業系統版本升級至下一個操作系統版本，或當應用程式呼叫 Win32 AddPrinterDriver 函式來更新印表機驅動程式時，就會發生這種情況。

通常，新的驅動程式版本需要與舊版不同的登錄設定。 DrvUpgradePrinter 函式的目的是要更新登錄，使其與驅動程式相容。 如需將印表機資訊儲存在登錄中的詳細資訊，請參閱 DrvPrinterEvent。

針對 Windows 2000 和更新版本，當多任務緩衝處理器呼叫 DrvUpgradePrinter 時，它會提供 pDriverUpgradeInfo 的DRIVER_UPGRADE_INFO_2結構指標。 如果函式傳回 FALSE，多任務緩衝處理程式會再次呼叫函式，這次指定DRIVER_UPGRADE_INFO_1結構指標。 如果此呼叫傳回 FALSE，多任務緩衝處理程式會在事件記錄檔中寫入專案。

針對 Windows NT 4.0 和先前版本，當多任務緩衝處理器呼叫DrvUpgradePrinter時，它會提供 pDriverUpgradeInfo 的DRIVER_UPGRADE_INFO_1結構指標。 如果函式傳回 FALSE，多任務緩衝處理程式會在事件記錄檔中寫入專案。

規格需求

需求 值
目標平台 桌面
標頭 winddiui.h (包含Winddiui.h)

另請參閱

DRIVER_UPGRADE_INFO_1

DRIVER_UPGRADE_INFO_2

DrvPrinterEvent