Collapse All Expand All

LDicomPrintSCU::OnPrinterReport

#include "ltdic.h"

virtual L_VOID LDicomPrintSCU::OnPrinterReport(uEventTypeID, pReportInfo)

L_UINT16 uEventTypeID;	/* Event Type ID */
const pPRINTERREPORTINFO pReportInfo;	/* printer report info */

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

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

Required DLLs and Libraries

LTDIC For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64

See Also

Functions:	Class Members, LDicomPrintSCU::GetPrinterInfo, LDicomPrintSCU::GetPrinterConfiguration
Topics:	Print Management SCU
	DICOM Print Management Service Class User: Functions

Example

For an example, refer to LDicomPrintSCU::OnStatus.