Fonction RouterAllocPrinterNotifyInfo (winsplp.h)

Article
03/01/2024

La fonction du RouterAllocPrinterNotifyInfo spouleur d’impression alloue une structure PRINTER_NOTIFY_INFO et un tableau de structures PRINTER_NOTIFY_INFO_DATA. (Ces structures sont décrites dans la documentation Microsoft Windows SDK.)

Syntaxe

PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
  DWORD cPrinterNotifyInfoData
);

Paramètres

cPrinterNotifyInfoData

Numéro fourni par l’appelant spécifiant la taille du tableau de structure PRINTER_NOTIFY_INFO_DATA à allouer.

Valeur retournée

La fonction retourne un pointeur vers la structure PRINTER_NOTIFY_INFO allouée.

Remarques

Les fournisseurs d’impression doivent appeler RouterAllocPrinterNotifyInfo pour allouer la structure PRINTER_NOTIFY_INFO et le tableau de structure PRINTER_NOTIFY_INFO_DATA que la fonction RefreshPrinterChangeNotification du fournisseur doit fournir.

La RouterAllocPrinterNotifyInfo fonction initialise le membre Version de la structure PRINTER_NOTIFY_INFO sur la version actuelle de l’implémentation de notification du spouleur. Il initialise les membres Flag etCount de la structure sur zéro, quel que soit le nombre spécifié pour cPrinterNotifyInfoData.

Les fournisseurs d’impression doivent appeler AppendPrinterNotifyInfoData pour renseigner les membres du tableau de structure PRINTER_NOTIFY_INFO_DATA.

Si RefreshPrinterChangeNotification s’exécute correctement et retourne les structures allouées à l’appelant, vous devez supposer que l’appelant libère la mémoire de structure. Toutefois, si RefreshPrinterChangeNotification rencontre une erreur, il doit appeler RouterFreePrinterNotifyInfo pour libérer la mémoire.

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