OnReceiveCMoveResponse Method

Summary

Notifies a connection that a C-MOVE-RSP command was received.

Syntax

Objective-C

C++/CLI

protected virtual void OnReceiveCMoveResponse( 
   byte presentationID, 
   int messageID, 
   string affectedClass, 
   DicomCommandStatusType status, 
   int remaining, 
   int completed, 
   int failed, 
   int warning, 
   DicomDataSet dataSet 
)

- (void)onReceiveCMoveResponse:(uint8_t)presentationID messageID:(uint16_t)messageID affectedClass:(NSString *)affectedClass status:(LTDicomCommandStatusType)status remaining:(uint16_t)remaining completed:(uint16_t)completed failed:(uint16_t)failed warning:(uint16_t)warning dataSet:(null_unspecified LTDicomDataSet *)dataSet;

protected: 
virtual void OnReceiveCMoveResponse(  
   byte presentationID, 
   int messageID, 
   String^ affectedClass, 
   DicomCommandStatusType status, 
   int remaining, 
   int completed, 
   int failed, 
   int warning, 
   DicomDataSet^ dataSet 
)

Parameters

presentationID
The Presentation Context ID. The ID provides information about both the class type of the data and the Transfer Syntax to use when transferring the data.

messageID
The Message ID. Each message sent by a member of a connection should have a unique ID. Since a member of a connection may send several messages, this ID allows that member to identify when a specific request has been completed.

affectedClass
The class affected by the request. This will be a SOP Class or a Meta SOP Class.

status
The status of the original request.

remaining
The number of remaining instances to search.

completed
The number of instances searched.

failed
The number of instances that failed the search.

warning
The number of instances in which warnings occurred.

dataSet
A DicomDataSet object that contains the Data Set which holds additional information about a non-successful C-MOVE sub-operation.

Remarks

A call to this method is generated on an SCU when SendCMoveResponse is called by the SCP. To customize this method, you must derive a class from DicomNet and override this method.

Example

using Leadtools; 
using Leadtools.Dicom; 
 
 
[StructLayout(LayoutKind.Sequential)] 
public struct MSG 
{ 
   public IntPtr hwnd; 
   public uint message; 
   public IntPtr wParam; 
   public IntPtr lParam; 
   public uint time; 
   public System.Drawing.Point p; 
} 
 
public enum WaitReturn 
{ 
   Complete, 
   Timeout, 
} 
 
class Utils 
{ 
   [DllImport("user32.dll")] 
   [return: MarshalAs(UnmanagedType.Bool)] 
   static extern bool PeekMessage(out MSG lpMsg, IntPtr hWnd, 
                                  uint wMsgFilterMin, uint wMsgFilterMax, 
                                  uint wRemoveMsg); 
 
   [DllImport("user32.dll")] 
   static extern bool TranslateMessage([In] ref MSG lpMsg); 
   [DllImport("user32.dll")] 
   static extern IntPtr DispatchMessage([In] ref MSG lpmsg); 
 
   const uint PM_REMOVE = 1; 
 
   public static WaitReturn WaitForComplete(double mill, WaitHandle wh) 
   { 
      TimeSpan goal = new TimeSpan(DateTime.Now.AddMilliseconds(mill).Ticks); 
 
      do 
      { 
         MSG msg = new MSG(); 
 
         if (PeekMessage(out msg, IntPtr.Zero, 0, 0, PM_REMOVE)) 
         { 
            TranslateMessage(ref msg); 
            DispatchMessage(ref msg); 
         } 
 
         if (wh.WaitOne(new TimeSpan(0, 0, 0), false)) 
         { 
            return WaitReturn.Complete; 
         } 
 
         if (goal.CompareTo(new TimeSpan(DateTime.Now.Ticks)) < 0) 
         { 
            return WaitReturn.Timeout; 
         } 
 
      } while (true); 
   } 
} 
 
class Client : DicomNet 
{ 
   DicomExceptionCode _LastError = DicomExceptionCode.Success; 
   AutoResetEvent waitEvent = new AutoResetEvent(false); 
 
   public Client() 
       : base(null, DicomNetSecurityMode.None) 
   { 
   } 
 
   public DicomExceptionCode LastError 
   { 
      get 
      { 
         return _LastError; 
      } 
   } 
 
   public bool Wait() 
   { 
      WaitReturn ret; 
 
      _LastError = DicomExceptionCode.Success; 
      ret = Utils.WaitForComplete((5 * 60) * 1000, waitEvent); 
 
      return (ret == WaitReturn.Complete); 
   } 
 
   protected override void OnConnect(DicomExceptionCode error) 
   { 
      _LastError = error; 
      waitEvent.Set(); 
   } 
 
   protected override void OnReceiveAssociateAccept(DicomAssociate association) 
   { 
      waitEvent.Set(); 
   } 
 
   protected override void OnReceiveCMoveResponse(byte presentationID, int messageID, string affectedClass, DicomCommandStatusType status, int remaining, int completed, int failed, int warning, DicomDataSet dataSet) 
   { 
      byte id = Association.FindAbstract(affectedClass); 
 
      Debug.Assert(dataSet != null, "Dataset should not be null"); 
      Debug.Assert(id == presentationID, "PresentationID is invalid"); 
      Debug.Assert(messageID == 1, "Invalid message id.  Should be 1"); 
      Debug.Assert(affectedClass == DicomUidType.PatientRootQueryMove, "Affected class should be PatientRootQueryMove: " + DicomUidType.PatientRootQueryMove); 
      Debug.Assert(status == DicomCommandStatusType.Success, "Status should be success"); 
      Debug.Assert(remaining == 0, "Remaining should be 0"); 
      Debug.Assert(completed == 1, "Completed should be 1"); 
      Debug.Assert(failed == 0, "Failed should be 0"); 
      Debug.Assert(warning == 0, "Warning should be 0"); 
 
      waitEvent.Set(); 
   } 
} 
 
class ServerConnection : DicomNet 
{ 
   public ServerConnection() 
       : base(null, DicomNetSecurityMode.None) 
   { 
   } 
 
   protected override void OnReceiveAssociateRequest(DicomAssociate association) 
   { 
      DicomAssociate retAssociation = new DicomAssociate(false); 
 
      Debug.Assert(association.Called == "ServerTest", "Called AETitle should be ServerTest"); 
      Debug.Assert(association.Calling == "ClientTest", "Calling AETitle should be ClientTest"); 
      Debug.Assert(association.ImplementClass == "1.2.840.114257.1", "Implementation class should be 1.2.840.114257.1"); 
      Debug.Assert(association.ImplementationVersionName == "1", "Implementation version should be 1"); 
      Debug.Assert(association.MaxLength == 0x100000, "Max length should be 0x100000"); 
      Debug.Assert(association.GetAbstract(1) == DicomUidType.VerificationClass, "Presentation index 1 should be " + DicomUidType.VerificationClass); 
      Debug.Assert(association.GetTransfer(1, 0) == DicomUidType.ImplicitVRLittleEndian, "Abstract Syntax (1,0) should be " + DicomUidType.ImplicitVRLittleEndian); 
 
      // 
      // Build our Association Accept 
      // 
      retAssociation.Called = association.Called; 
      retAssociation.Calling = association.Calling; 
      retAssociation.ImplementClass = association.ImplementClass; 
      retAssociation.ImplementationVersionName = association.ImplementationVersionName; 
      for (int x = 0; x < association.PresentationContextCount; x++) 
      { 
         byte id = association.GetPresentationContextID(x); 
         string abSyntax = association.GetAbstract(id); 
         string trSyntax = DicomUidType.ImplicitVRLittleEndian; 
 
         retAssociation.AddPresentationContext(id, 0, abSyntax); 
         if (association.GetTransferCount(id) > 0) 
         { 
            trSyntax = association.GetTransfer(id, 0); 
         } 
 
         retAssociation.AddTransfer(id, trSyntax); 
      } 
      SendAssociateAccept(retAssociation); 
   } 
 
   protected override void OnReceiveCMoveRequest(byte presentationID, int messageID, string affectedClass, DicomCommandPriorityType priority, string moveAE, DicomDataSet dataSet) 
   { 
      DicomElement element; 
      byte id = Association.FindAbstract(affectedClass); 
 
      Debug.Assert(id == presentationID, "PresentationID is invalid"); 
      Debug.Assert(messageID == 1, "Invalid message id.  Should be 1"); 
      Debug.Assert(dataSet != null, "Dataset should not be null"); 
      Debug.Assert(affectedClass == DicomUidType.PatientRootQueryMove, "Affected class should be PatientRootQueryMove: " + DicomUidType.PatientRootQueryMove); 
      Debug.Assert(priority == DicomCommandPriorityType.Medium, "Priority should be medium"); 
      Debug.Assert(moveAE == "CLIENT", "Move AE should be CLIENT"); 
 
      // 
      // Check Dataset 
      // 
      element = dataSet.FindFirstElement(null, DicomTag.QueryRetrieveLevel, true); 
      Debug.Assert(element != null, "Element (QueryRetrieveLevel) should not be null"); 
      Debug.Assert(dataSet.GetStringValue(element, 0) == "IMAGE", "QueryRetrieveLevel should be PATIENT"); 
 
      element = dataSet.FindFirstElement(null, DicomTag.PatientID, true); 
      Debug.Assert(element != null, "Element (PatientID) should not be null"); 
      Debug.Assert(dataSet.GetStringValue(element, 0) == "ID", "PatientID should be ID not " + dataSet.GetStringValue(element, 0)); 
 
      element = dataSet.FindFirstElement(null, DicomTag.StudyInstanceUID, true); 
      Debug.Assert(element != null, "Element (StudyInstanceUID) should not be null"); 
      Debug.Assert(dataSet.GetStringValue(element, 0) == "1.2.3.4.5.6.111111.1", "StudyInstanceUID should be 1.2.3.4.5.6.111111.1"); 
 
      element = dataSet.FindFirstElement(null, DicomTag.SeriesInstanceUID, true); 
      Debug.Assert(element != null, "Element (SeriesInstanceUID) should not be null"); 
      Debug.Assert(dataSet.GetStringValue(element, 0) == "1.2.3.4.5.6.111111.99", "SeriesInstanceUID should be 1.2.3.4.5.6.111111.99"); 
 
      element = dataSet.FindFirstElement(null, DicomTag.SOPInstanceUID, true); 
      Debug.Assert(element != null, "Element (SOPInstanceUID) should not be null"); 
      Debug.Assert(dataSet.GetStringValue(element, 0) == "1.2.3.4.5.6.111111.1000", "SOPInstanceUID should be 1.2.3.4.5.6.111111.1000"); 
 
      SendCMoveResponse(presentationID, messageID, affectedClass, DicomCommandStatusType.Success, 0, 1, 0, 0, dataSet); 
   } 
} 
 
class Server : DicomNet 
{ 
   ServerConnection client; 
 
   public Server() 
       : base(null, DicomNetSecurityMode.None) 
   { 
   } 
 
   protected override void OnAccept(DicomExceptionCode error) 
   { 
      client = new ServerConnection(); 
 
      Accept(client); 
   } 
} 
 
public void SendCMoveRequestSample() 
{ 
   DicomEngine.Startup(); 
   DicomNet.Startup(); 
 
   using (Server server = new Server()) 
   { 
      using (Client client = new Client()) 
      { 
         // 
         // Connect to server 
         // 
         server.Listen("127.0.0.1", 104, 1); // start server 
         client.Connect(null, 1000, "127.0.0.1", 104); // connect to server 
         if (!client.Wait()) // wait for connection to finish 
         { 
            Debug.Fail("Connection timed out"); 
         } 
         Assert.IsTrue(client.LastError == DicomExceptionCode.Success, "Connection failed"); 
         Assert.IsTrue(client.IsConnected() == true, "Client not connected"); 
 
         // 
         // Send associate request 
         // 
         DicomAssociate associate = new DicomAssociate(true); 
 
         associate.Called = "ServerTest"; 
         associate.Calling = "ClientTest"; 
         associate.ImplementClass = "1.2.840.114257.1"; 
         associate.ImplementationVersionName = "1"; 
         associate.MaxLength = 0x100000; 
         associate.AddPresentationContext(1, 0, DicomUidType.VerificationClass); 
         associate.AddTransfer(1, DicomUidType.ImplicitVRLittleEndian); 
         associate.AddPresentationContext(3, 0, DicomUidType.PatientRootQueryMove); 
         associate.AddTransfer(3, DicomUidType.ImplicitVRLittleEndian); 
         client.SendAssociateRequest(associate); 
         if (!client.Wait()) // wait for connection to finish 
         { 
            Debug.Fail("SendAssociateRequest timed out"); 
         } 
 
         // 
         // Send Echo Request 
         // 
         byte pid = client.Association.FindAbstract(DicomUidType.PatientRootQueryMove); 
         DicomDataSet ds = new DicomDataSet(); 
         DicomElement element; 
 
         // 
         // Set up the find parameters 
         // 
         ds.Reset(); 
         ds.Initialize(DicomClassType.PatientRootQueryImage, DicomDataSetInitializeType.ExplicitVRLittleEndian); 
         element = ds.FindFirstElement(null, DicomTag.QueryRetrieveLevel, true); 
         if (element == null) 
         { 
            element = ds.InsertElement(null, false, DicomTag.QueryRetrieveLevel, DicomVRType.UN, false, 0); 
         } 
         ds.SetStringValue(element, "IMAGE", DicomCharacterSetType.Default); 
 
         element = ds.FindFirstElement(null, DicomTag.PatientID, true); 
         if (element == null) 
         { 
            element = ds.InsertElement(null, false, DicomTag.PatientID, DicomVRType.UN, false, 0); 
         } 
         ds.SetStringValue(element, "ID", DicomCharacterSetType.Default); 
 
         element = ds.FindFirstElement(null, DicomTag.StudyInstanceUID, true); 
         if (element == null) 
         { 
            element = ds.InsertElement(null, false, DicomTag.StudyInstanceUID, DicomVRType.UN, false, 0); 
         } 
         ds.SetStringValue(element, "1.2.3.4.5.6.111111.1", DicomCharacterSetType.Default); 
 
         element = ds.FindFirstElement(null, DicomTag.SeriesInstanceUID, true); 
         if (element == null) 
         { 
            element = ds.InsertElement(null, false, DicomTag.SeriesInstanceUID, DicomVRType.UN, false, 0); 
         } 
         ds.SetStringValue(element, "1.2.3.4.5.6.111111.99", DicomCharacterSetType.Default); 
 
         element = ds.FindFirstElement(null, DicomTag.SOPInstanceUID, true); 
         if (element == null) 
         { 
            element = ds.InsertElement(null, false, DicomTag.SOPInstanceUID, DicomVRType.UN, false, 0); 
         } 
         ds.SetStringValue(element, "1.2.3.4.5.6.111111.1000", DicomCharacterSetType.Default); 
 
         client.SendCMoveRequest(pid, 1, DicomUidType.PatientRootQueryMove, DicomCommandPriorityType.Medium, "CLIENT", ds); 
         if (!client.Wait()) // wait for CMove to finish 
         { 
            Debug.Fail("SendCMoveRequest timed out"); 
         } 
         client.CloseForced(true); 
      } 
      server.CloseForced(true); 
   } 
 
   DicomEngine.Shutdown(); 
   DicomNet.Shutdown(); 
}