DicomObjects Reference
DicomObjects Reference / DicomQuery Object / GetUsingMove Method
GetUsingMove Method
Description
Synchronous retrieval of images using C-MOVE
Syntax
Visual Basic
Public Function GetUsingMove() As DicomImages
Remarks

This is a major new facility in DicomObjects, allowing C-MOVE to be used as easily as C-GET (GetImages).  This is important, as many commonly available servers refuse to support the C-GET protocol, forcing use of C-MOVE.  While MoveImages has been available in DicomObjects for some time, it is difficult to use, requiring close co-ordination between a listening object (DicomViewer or DicomServer) and a DicomQuery object.  GetUsingMove handles all the necessary co-ordination internally, opening a port, receiving the images, and presenting them, just like GetImages.  Before using this method, the DicomQuery object’s Destination and ReceivePort properties must have been set to appropriate values, such that the destination name is known to the server, and maps to the ReceivePort and IP address from which the query is being sent. 

Notes:

  • C-MOVE is more complicated to set up than C-GET, and there it cannot work unless the application entity name, port and IP address have been set up on the server.  This is a fundamental limitation of the protocol as only the destination AE title can be specified in a C-MOVE request, not a port or IP address.
  • The port used to receive the images may be shared between several simultaneous GetUsingMove requests (which will generally allocate the images appropriately), but it must not be in use by other listening objects such as a DicomViewer.
  • When receiving from eFilm, a special registry value “IgnoreMessageID” type DWORD, value 1 must be set alongside the other DicomObjects values, as eFilm does not send the correct information to allow images received to be matched to the request.
See Also