Fonction FindFirstPrinterChangeNotification (winspool.h)

Article
03/01/2024

Avertissement

À compter de Windows 10, les API qui prennent en charge les fournisseurs d’impression tiers sont déconseillées. Microsoft ne recommande aucun investissement dans des fournisseurs d’impression tiers. En outre, sur Windows 8 et les produits plus récents où le modèle de pilote d’impression v4 est disponible, les fournisseurs d’impression tiers peuvent ne pas créer ou gérer de files d’attente qui utilisent des pilotes d’impression v4.

La fonction FindFirstPrinterChangeNotification d’un fournisseur d’impression informe le fournisseur qu’une application a demandé une notification lorsqu’un ensemble d’événements spécifié se produit dans une file d’attente d’impression spécifiée.

Syntaxe

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

Paramètres

hPrinter

Handle d’imprimante fourni par l’appelant, identifiant l’imprimante pour laquelle la notification d’événement est demandée. Ce handle doit avoir été obtenu précédemment à partir d’OpenPrinter.

fdwFilter

Définit le paramètre DWORD fdwFilter.

fdwOptions

Non utilisé.

pPrinterNotifyOptions

Pointeur fourni par l’appelant vers une structure de PRINTER_NOTIFY_OPTIONS (décrit dans la documentation SDK Windows).

Valeur retournée

Retourne le handle du pilote d’impression.

Remarques

Lorsque le spouleur appelle la fonction FindFirstPrinterChangeNotification d’un fournisseur d’impression, pPrinterNotifyOptions identifie les types d’informations que le fournisseur d’impression doit envoyer au spouleur lorsqu’un des événements spécifiés se produit.

Pour obtenir la liste des types de notifications qu’une application peut demander, et pour obtenir la liste des types d’informations qui peuvent être utilisés pour décrire un événement, consultez la description de la documentation du SDK Windows de FindFirstPrinterChangeNotification. Les types d’événements pour lesquels une application peut demander une notification incluent l’ajout ou la suppression d’un travail ou d’un formulaire d’impression. Les types d’informations qu’une application peut demander incluent des paramètres de travail ou de formulaire.

Si le fournisseur d’impression ne demande pas d’interrogation, le fournisseur d’impression doit fournir les types d’informations identifiés par pPrinterNotifyOptions, en appelant PartialReplyPrinterChangeNotification ou ReplyPrinterChangeNotification.

Si le fournisseur demande l’interrogation (autrement dit, il définit PRINTER_NOTIFY_STATUS_POLL), il ne doit pas appeler ReplyPrinterChangeNotification. Au lieu de cela, le spouleur signale l’application à intervalles réguliers.

Le fournisseur d’impression interrogé et non pollué doit retourner l’état actuel de tous les types d’informations demandés chaque fois que sa fonction RefreshPrinterChangeNotification est appelée.

Pour plus d’informations, consultez Prise en charge des notifications de modification d’imprimante.