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 |
See Also
Functions: |
Class Members, LDicomPrintSCU::GetPrinterInfo, LDicomPrintSCU::GetPrinterConfiguration |
Topics: |
|
|
Example
For an example, refer to LDicomPrintSCU::OnStatus.