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