In This Topic ▼

LDicomPrintSCU::OnPrinterReport

Summary

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

Syntax

#include "ltdic.h"

virtual L_VOID LDicomPrintSCU::OnPrinterReport(uEventTypeID, pReportInfo)

Parameters

L_UINT16 uEventTypeID

Specifies the Event Type ID which indicates normal, warning, or failure conditions. Possible values are:

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

const pPRINTERREPORTINFO pReportInfo

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 parameter uEventTypeID is equal to 1 (normal condition).

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