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.

Member Description
pfnStatus Called to indicate the status of the Print SCU
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

When the function L_DicomPrintSCUCreateFilmSession is called to create a Film Session (and assuming that the function succeeds), the callback function pfnStatus will be called twice: The first time with uStatus set to PRINTSCU_STATUS_SEND_CREATE_FILM_SESSION_RQ and uOperationStatus set to 0, and the second time with uStatus set to PRINTSCU_STATUS_RECEIVE_CREATE_FILM_SESSION_RSP and uOperationStatus set to COMMAND_STATUS_SUCCESS.

When the parameter uStatus is one of the PRINTSCU_STATUS_xxx_RSP status values, the parameter uOperationStatus is determined as follows:

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 pszPrinterStatusInfo member of the PRINTERREPORTINFO structure).

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).

Help Version 20.0.2019.3.12
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2019 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help