Funzione FindFirstPrinterChangeNotification (winspool.h)

Articolo
02/27/2024

Avviso

A partire da Windows 10, le API che supportano provider di stampa di terze parti sono deprecate. Microsoft non consiglia alcun investimento nei provider di stampa di terze parti. Inoltre, nei Windows 8 e nei prodotti più recenti in cui è disponibile il modello di driver di stampa v4, i provider di stampa di terze parti potrebbero non creare o gestire code che usano i driver di stampa v4.

La funzione FindFirstPrinterChangeNotification di un provider di stampa informa il provider che un'applicazione ha richiesto una notifica quando si verificano un set specificato di eventi in una coda di stampa specificata.

Sintassi

HANDLE FindFirstPrinterChangeNotification(
  HANDLE hPrinter,
  DWORD  fdwFilter,
  DWORD  fdwOptions,
  PVOID  pPrinterNotifyOptions
);

Parametri

hPrinter

Handle stampante fornito dal chiamante, identificando la stampante per cui viene richiesta la notifica degli eventi. Questo handle deve essere stato ottenuto in precedenza da OpenPrinter.

fdwFilter

Definisce il parametro DWORD fdwFilter.

fdwOptions

Non usato.

pPrinterNotifyOptions

Puntatore fornito dal chiamante a una struttura PRINTER_NOTIFY_OPTIONS (descritta nella documentazione di Windows SDK).

Valore restituito

Restituisce l'handle del driver di stampa.

Commenti

Quando lo spooler chiama la funzione FindFirstPrinterChangeNotification del provider di stampa, pPrinterNotifyOptions identifica i tipi di informazioni che il provider di stampa deve inviare al spooler quando si verifica uno degli eventi specificati.

Per un elenco dei tipi di notifiche che un'applicazione può richiedere e per un elenco dei tipi di informazioni che possono essere usate per descrivere un evento, vedere Windows SDK la descrizione della documentazione di FindFirstPrinterChangeNotification. I tipi di eventi per cui un'applicazione potrebbe richiedere la notifica includono l'aggiunta o l'eliminazione di un processo di stampa o di un modulo. I tipi di informazioni che un'applicazione potrebbe richiedere includono parametri di processo o modulo.

Se il provider di stampa non richiede il polling, il provider di stampa deve fornire i tipi di informazioni identificate da pPrinterNotifyOptions chiamando PartialReplyPrinterChangeNotification o ReplyPrinterChangeNotification.

Se il provider richiede il polling ( ovvero, imposta PRINTER_NOTIFY_STATUS_POLL), non deve chiamare ReplyPrinterChangeNotification. Il spooler segnala invece l'applicazione a intervalli regolari.

Sia il provider di stampa polled che nonpolled devono restituire lo stato corrente di tutti i tipi di informazioni richiesti ogni volta che viene chiamata la funzione RefreshPrinterChangeNotification .

Per altre informazioni, vedere Supporto delle notifiche di modifica della stampante.