RouterAllocPrinterNotifyInfo 函式 (winsplp.h)

發行項
03/01/2024

列印多任務緩衝處理器的 RouterAllocPrinterNotifyInfo 函式會配置PRINTER_NOTIFY_INFO結構和PRINTER_NOTIFY_INFO_DATA結構的數位。 (這些結構會在 Microsoft Windows SDK documentation.) 中說明

語法

PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
  DWORD cPrinterNotifyInfoData
);

參數

cPrinterNotifyInfoData

呼叫端提供的號碼，指定要配置之PRINTER_NOTIFY_INFO_DATA結構陣列的大小。

傳回值

函式會傳回已配置PRINTER_NOTIFY_INFO結構的指標。

備註

列印提供者應該呼叫 RouterAllocPrinterNotifyInfo 來配置PRINTER_NOTIFY_INFO結構，以及提供者的 RefreshPrinterChangeNotification 函式必須提供的PRINTER_NOTIFY_INFO_DATA結構數位。

函 RouterAllocPrinterNotifyInfo 式會將PRINTER_NOTIFY_INFO結構的 Version 成員初始化為目前版本的多任務緩衝處理程式通知實作。不論為 cPrinterNotifyInfoData 指定的數位為何，它都會將結構的 Flags 和 Count 成員初始化為零。

列印提供者應該呼叫 AppendPrinterNotifyInfoData 來填入PRINTER_NOTIFY_INFO_DATA結構陣列的成員。

如果 RefreshPrinterChangeNotification 成功執行，並將配置的結構傳回給呼叫端，您應該假設呼叫端會解除分配結構記憶體。不過，如果 RefreshPrinterChangeNotification 發生錯誤，它應該呼叫 RouterFreePrinterNotifyInfo 來解除分配記憶體。

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