In This Topic ▼

PRINTSCUPRINTERREPORTCALLBACK

#include "ltdic.h"

L_VOID pEXT_CALLBACK Your Function(hCU, uEventTypeID, pReportInformation, pUserData)

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

Parameters

HDICOMPRINTSCU hCUpCallback

Handle to the DICOM Print SCU.

L_INT16 uEventTypeID

The Event Type ID which indicates normal, warning, or failure conditions. The following values are possible:

Value	Meaning
1	Normal condition (Event Type Name = Normal). In this case, the pReportInfo parameter will be NULL.
2	Warning condition (Event Type Name = Warning).
3	Failure condition (Event Type Name = Failure).

const pPRINTERREPORTINFO pReportInformation

Pointer to a PRINTERREPORTINFO structure that specifies printer information in warning and failure conditions. This can be NULL and it is always NULL if the uEventTypeID parameter is equal to 1 (normal condition).

const L_VOID * pUserData

Pointer to user-defined data.

Returns

None.

Comments

This callback function is called whenever the Print SCU receives a report from the Print SCP about the changes of the printer status, as follows:

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.

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

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.

Required DLLs and Libraries