DICOMPRINTSCUCALLBACK

typedef struct _DICOMPRINTSCUCALLBACK 
{ 
   PRINTSCUSTATUSCALLBACK pfnStatus; 
   PRINTSCUPRINTERREPORTCALLBACK pfnPrinterReport; 
   PRINTSCUPRINTJOBREPORT pfnPrintJobReport; 
   L_VOID * pUserData; 
} DICOMPRINTSCUCALLBACK, * pDICOMPRINTSCUCALLBACK; 

The DICOMPRINTSCUCALLBACK defines a set of callback functions related to the DICOM Print SCU.

Members

pfnStatus

pfnPrinterReport

Called when a printer status report is received from the Print SCP.

pfnPrintJobReport

Called when a Print Job status report is received from the Print SCP.

pUserData

Sets the user-defined data which will be passed back in the callbacks.

Comments

pfnStatus

pfnPrinterReport

This callback function is called whenever the Print SCU receives a report from the Print SCP about the changes of the printer status. If any of the three Meta SOP Classes (the Basic Grayscale Print Management Meta SOP Class, the Basic Color Print Management Meta SOP Class, or the Pull Stored Print Management Meta SOP Class) is supported on the Association, the Printer SOP Class is also supported and hence the function is expected to be called. If none of the three Meta SOP Classes is supported, the function will never be called.

In warning and failure conditions, the Print SCP is supposed to supply additional information about the printer status in the Attribute Printer Status Info (the member pszPrinterStatusInfo of the PRINTERREPORTINFO structure).

The implementation of the LDicomPrintSCU class for this function simply does nothing. In order to make use of this callback function, you should create a new class derived from the LDicomPrintSCU and override the function providing the desired implementation.

pfnPrinterJobReport

This callback function is called whenever the Print SCU receives a report from the Print SCP about the changes in the status of a Print Job. The intended Print Job is specified by its SOP Instance UID. If the Print Job SOP Class is supported on the Association, this function is expected to be called. Otherwise, it will never be called.

If the status of the Print Job is Pending or Failure, the Print SCP is supposed to supply additional information about the pending/error condition in the Attribute Execution Status Info (the pszExecutionStatusInfo member of the PRINTJOBREPORTINFO structure).

The implementation of the LDicomPrintSCU class for this function simply does nothing. In order to make use of this callback function, you should create a new class derived from the LDicomPrintSCU and override the function providing the desired implementation.