DicomObjects Reference
DicomObjects Reference / DicomQuery Object / GetUsingMove Method
In This Topic
    GetUsingMove Method
    In This Topic
    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