RouterAllocPrinterNotifyInfo 函数 (winsplp.h)

项目
08/08/2023

打印后台处理程序的 RouterAllocPrinterNotifyInfo 函数分配PRINTER_NOTIFY_INFO结构和PRINTER_NOTIFY_INFO_DATA结构的数组。 (Microsoft Windows SDK 文档中介绍了这些结构。)

语法

PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
  DWORD cPrinterNotifyInfoData
);

参数

cPrinterNotifyInfoData

调用方提供的号码，指定要分配的PRINTER_NOTIFY_INFO_DATA结构数组的大小。

返回值

函数返回指向已分配PRINTER_NOTIFY_INFO结构的指针。

注解

打印提供程序应调用 RouterAllocPrinterNotifyInfo 以分配提供程序的 RefreshPrinterChangeNotification 函数必须提供的PRINTER_NOTIFY_INFO结构和PRINTER_NOTIFY_INFO_DATA结构数组。

函数 RouterAllocPrinterNotifyInfo 将 PRINTER_NOTIFY_INFO 结构的 Version 成员初始化为后台处理程序通知实现的当前版本。它将结构的 Flags 和 Count 成员初始化为零，而不考虑为 cPrinterNotifyInfoData 指定的数字。

打印提供程序应调用 AppendPrinterNotifyInfoData 来填充PRINTER_NOTIFY_INFO_DATA结构数组的成员。

如果 RefreshPrinterChangeNotification 成功执行并将分配的结构返回到调用方，则应假定调用方将解除分配结构内存。但是，如果 RefreshPrinterChangeNotification 遇到错误，应调用 RouterFreePrinterNotifyInfo 来解除分配内存。

有关其他信息，请参阅支持打印机更改通知。