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