OnPrinterReport Method

Summary

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

Syntax

C++

public virtual void OnPrinterReport( 
   int eventTypeID, 
   DicomPrinterReportInformation reportInformation 
)

Public Overridable Sub OnPrinterReport( _ 
   ByVal eventTypeID As Integer, _ 
   ByVal reportInformation As DicomPrinterReportInformation _ 
)

public: 
virtual void OnPrinterReport(  
   int eventTypeID, 
   DicomPrinterReportInformation^ reportInformation 
)

Parameters

eventTypeID
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 reportInformation will be a null reference (Nothing in Visual Basic).
2	Warning condition (Event Type Name = Warning).
3	Failure condition (Event Type Name = Failure).

reportInformation
A DicomPrinterReportInformation object that specifies printer information in warning and failure conditions. This can be a null reference (Nothing in VB) and it is always a null reference if the parameter [eventTypeID](" id="eventtypeidparameterlink" class="popuplink.html) is equal to 1 (normal condition).

Remarks

This callback method is called whenever the Print SCU receives a report from the Print SCP about the changes of the printer status. If any of the two Meta SOP Classes (the Basic Grayscale Print Management Meta SOP Class and the Basic Color Print Management Meta SOP Class) is supported on the Association, the Printer SOP Class is also supported and hence the method is expected to be called. If none of the two Meta SOP Classes is supported, the method 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 property PrinterStatusInfo of the DicomPrinterReportInformation class).

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

Example

For an example, refer to Associate.

Requirements

Target Platforms