drvDriverEvent 函式 (winddiui.h)

  • 發行項

當多任務緩衝處理器處理可能需要印表機驅動程式動作的驅動程式特定事件時，列印後台處理程式會呼叫印表機介面 DLL 的 DrvDriverEvent 函式。

語法

BOOL DrvDriverEvent(
                 DWORD  dwDriverEvent,
                 DWORD  dwLevel,
  [in, optional] LPBYTE pDriverInfo,
                 LPARAM lParam
);

參數

dwDriverEvent

呼叫端提供的位旗標，指出已發生的事件。 下表列出有效的旗標。

旗標 定義
DRIVER_EVENT_DELETE 正在移除驅動程式。
DRIVER_EVENT_INITIALIZE 驅動程式剛安裝。

dwLevel

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

dwLevel 價值 pDriverInfo 所指向的結構
1 DRIVER_INFO_1
2 DRIVER_INFO_2
3 DRIVER_INFO_3

Microsoft Windows SDK 檔中會說明DRIVER_INFO_N 結構。

[in, optional] pDriverInfo

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

lParam

呼叫端提供的旗標。 請參閱下列一節。

傳回值

如果作業成功，函式應該會傳回 TRUE。 否則，它應該會傳回 FALSE。

備註

選擇性 DrvDriverEvent 函式是由多任務緩衝處理器的 AddPrinterDriverEx 和 DeletePrinterDriverEx 函式所呼叫，如 Windows SDK 檔中所述。

函式的目的是允許印表機驅動程式的 印表機介面 DLL 在安裝或移除驅動程式時執行所需的作業。 執行此函式的一般作業是建立或移除 印表機 INF 檔案中未指定為相依檔案的額外驅動程式特定檔案。

如果 dwDriverEvent 是 DRIVER_EVENT_DELETE，lparam 參數會包含為 DeletePrinterDriverEx 函式的 dwDeleteFlag 參數指定的旗標。 如果 dwDriverEvent DRIVER_EVENT_INITIALIZE，則不會使用 lparam 參數。

因為 DrvDriverEvent 函式是在列印後台處理程式的內容中呼叫，所以無法顯示使用者介面。

規格需求

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