FindFirstPrinterChangeNotification 函式 (winspool.h)
警告
從 Windows 10 開始,支援第三方列印提供者的 API 已被取代。 Microsoft不建議對第三方列印提供者進行任何投資。 此外,在提供 v4 列印驅動程式模型的 Windows 8 和較新版本產品上,第三方列印提供者可能無法建立或管理使用 v4 列印驅動程式的佇列。
列印提供者的 FindFirstPrinterChangeNotification 函式會通知提供者,當指定的列印佇列上發生一組指定的事件時,應用程式已要求通知。
語法
HANDLE FindFirstPrinterChangeNotification(
HANDLE hPrinter,
DWORD fdwFilter,
DWORD fdwOptions,
PVOID pPrinterNotifyOptions
);
參數
hPrinter
呼叫端提供的印表機句柄,識別要求事件通知的印表機。 此句柄先前必須從 OpenPrinter取得。
fdwFilter
定義 fdwFilter DWORD 參數。
fdwOptions
未使用。
pPrinterNotifyOptions
呼叫端提供的PRINTER_NOTIFY_OPTIONS結構的指標(如 Windows SDK 檔所述)。
傳回值
傳回列印驅動程式句柄。
言論
當多任務緩衝處理器呼叫列印提供者的 FindFirstPrinterChangeNotification 函式時,pPrinterNotifyOptions 識別列印提供者在發生其中一個指定事件時應該傳送至多任務緩衝處理程式的信息類型。
如需應用程式可要求之通知類型的清單,以及可用來描述事件的信息類型清單,請參閱 Windows SDK 檔描述 FindFirstPrinterChangeNotification。 應用程式可能會要求通知的事件類型包括新增或刪除列印作業或窗體。 應用程式可能要求的信息類型包括作業或窗體參數。
如果列印提供者未要求輪詢,則列印提供者必須呼叫 PartialReplyPrinterChangeNotification 或 ReplyPrinterChangeNotification,提供 pPrinterNotifyOptions所識別的資訊類型。
如果提供者確實要求輪詢(也就是設定PRINTER_NOTIFY_STATUS_POLL),則不應該呼叫 ReplyPrinterChangeNotification。 反之,多任務緩衝處理程式會定期向應用程式發出訊號。
每當呼叫所有要求的信息類型 RefreshPrinterChangeNotification 函式時,輪詢和非數據列印提供者都必須傳回所有要求資訊類型的目前狀態。
如需詳細資訊,請參閱 支援印表機變更通知。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | winspool.h (包括 Winspool.h) |
連結庫 | WinSpool.lib |
DLL | WinSpool.drv |
另請參閱
ReplyPrinterChangeNotification