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

定義 DWORD 參數 fdwFilter。

fdwOptions

未使用。

pPrinterNotifyOptions

呼叫端提供的PRINTER_NOTIFY_OPTIONS結構指標， (Windows SDK 檔) 中所述。

傳回列印驅動程式句柄。

當多任務緩衝處理程式呼叫列印提供者的 FindFirstPrinterChangeNotification 函式時， pPrinterNotifyOptions 會識別列印提供者在發生其中一個指定事件時應該傳送至多任務緩衝處理程式的信息類型。

如需應用程式可要求之通知類型的清單，以及可用來描述事件的信息類型清單，請參閱 Windows SDK 檔的說明 FindFirstPrinterChangeNotification。應用程式可能會要求通知的事件類型包括新增或刪除列印作業或窗體。應用程式可能要求的信息類型包括作業或窗體參數。

如果列印提供者未要求輪詢，則列印提供者必須藉由呼叫 PartialReplyPrinterChangeNotification 或 ReplyPrinterChangeNotification 來提供 pPrinterNotifyOptions 所識別的信息類型。

如果提供者要求輪詢 (，它會設定PRINTER_NOTIFY_STATUS_POLL) ，則不應該呼叫 ReplyPrinterChangeNotification。相反地，多任務緩衝處理會定期向應用程式發出訊號。

每當呼叫其 RefreshPrinterChangeNotification 函式時，輪詢和非推入的列印提供者都必須傳回所有要求資訊類型的目前狀態。

如需詳細資訊，請參閱支援印表機變更通知。