fired when an incoming N-EVENT-REPORT notification is received
This parameter is passed by reference, and should be set to the error code to be returned to the application generating the notification. Please see notes below however, as this event is called asynchronously, and this result is ignored unless the connection’s Mode is doNoSync.
| Visual Basic |
|---|
Public Event EventReport( _ ByVal Connection As DicomConnection, _ ByVal EventID As Integer, _ ByVal dataset As DicomDataSet, _ ByRef Status As Long _ ) |
This parameter is passed by reference, and should be set to the error code to be returned to the application generating the notification. Please see notes below however, as this event is called asynchronously, and this result is ignored unless the connection’s Mode is doNoSync.
In order for events to be generated the client application must establish a connection to an appropriate SCP, offering a Meta SOP class that supports the N-EVENT-REPORT operation. This is achieved by creating a DicomConnection object (using the New method, to enable the link between the DicomConnection and the event-enabled DicomViewer or DicomServer), and issuing a SetDestination call.
The handling of N-EVENT-REPORT notifications is complicated by their asynchronous arrival on associations which are for other purposes outgoing only (i.e. DicomObjects is SCU). This means that it is not always possible to fire this event synchronously, as an attempt to do so could produce a deadlock if called during an outgoing association. Consequently, the result is only used when the connection’s Mode property is doNoSync, as the rules imposed by this mode prevent a deadlock from occurring.