EventReport Event

In This Topic

Description

fired when an incoming N-EVENT-REPORT notification is received

Syntax

Visual Basic
Public Event EventReport( _ ByVal Connection As DicomConnection, _ ByVal EventID As Integer, _ ByVal dataset As DicomDataSet, _ ByRef Status As Long _ )

Visual Basic

Public Event EventReport( _
   ByVal Connection As DicomConnection, _
   ByVal EventID As Integer, _
   ByVal dataset As DicomDataSet, _
   ByRef Status As Long _
)

Parameters

Connection: The connection on which the notification is received.
EventID: The ID of the notification
dataset: The identifier received with the notification
Status: 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.

Remarks

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.