LDicomNet::OnReceiveCMoveRequest
#include "ltdic.h"
virtual L_VOID LDicomNet::OnReceiveCMoveRequest(nPresentationID, nMessageID, pszClass, nPriority, pszMoveAE, pDS)
L_UCHAR nPresentationID; |
/* presentation ID */ |
L_UINT16 nMessageID; |
/* message ID */ |
L_TCHAR * pszClass; |
/* class type */ |
L_UINT16 nPriority; |
/* priority of the message */ |
L_TCHAR * pszMoveAE; |
/* name of the application entity */ |
LDicomDS * pDS; |
/* data set to be moved */ |
Notifies a connection that a C-MOVE-REQ command was received. This function is available in the Medical Suite Toolkit.
Parameter |
Description |
|
nPresentationID |
Presentation ID. The presentation ID provides information about both the class type of the data and the transfer syntax to use when transferring the data. |
|
nMessageID |
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. |
|
pszClass |
Class affected by the request. This will be an SOP Class or an SOP MetaClass. |
|
nPriority |
The priority level of the message. The Service Class Provider may or may not support priority. Therefore, setting this parameter may or may not have any effect. Possible values are: |
|
|
Value |
Meaning |
|
COMMAND_PRIORITY_LOW |
[0x0002] Low priority message. |
|
COMMAND_PRIORITY_MEDIUM |
[0x0000] Medium priority message. |
|
COMMAND_PRIORTY_HIGH |
[0x0001] High priority message. |
pszMoveAE |
Character string that contains the name of the application entity that originally requested the move. For a simple storage request from a client to a server, this should be "". When the request is a sub-operation of a C-MOVE, this will contain the name of the AE that requested the move. |
|
pDS |
Pointer to the data set to be moved. |
Returns
None.
Comments
A call to this function is generated on an SCP when LDicomNet::SendCMoveRequest is called by the SCU.
To customize this function, you must derive a class from LDicomNet and override this function.
Required DLLs and Libraries
LTDIC For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application |
See Also
Example
//In this example:
//
//1. LMyDicomNet is a class derived from LDicomNet
//2. LMyDicomNet has the following member variables:
// m_nClientOrServer: can be (STATUS_NONE, STATUS_SERVER, STATUS_CLIENT)
// identifieds the LMyDicomNet object as a server or a client
// m_nDataCommand: can be (COMMAND_C_MOVE,COMMAND_C_GET)
// set so the server knows how a C-Store Response was generated
//
//3. m_pDicomNet points to a valid LMyDicomNet object
// LMyDicomNet *m_pDicomNet
//
//4. A connection exists between client and server
//5. An association exists between the client and server
L_VOID LMyDicomNet::OnReceiveCMoveRequest(L_UCHAR nPresentationID, L_UINT16 nMessageID, L_TCHAR *pszClass, L_UINT16 nPriority, L_TCHAR *pszMoveAE, LDicomDS *pDS) { CString strMsg; L_UINT lPeerPort; L_TCHAR szPeerAddress[100]; GetPeerInfo(szPeerAddress, 100, &lPeerPort); strMsg.Format(TEXT("*** OnReceiveCMoveRequest ***\nPeer[%s]\nnPresentationID[%d]\nnMessageID[%d]\npszClass[%s]\nnPriority[%d]pszMoveAE[%s]\npDS[%x]\n"), szPeerAddress, nPresentationID, nMessageID, pszClass, nPriority, pszMoveAE, pDS ); //The AE should check the data set, and perform //matching against the files stored on the AE to determine //what data set(s) should be moved to the destination AE. //For this sample, just send a predetermined file //load the sample file L_TCHAR * szFile = TEXT("d:\\work\\images\\dicom16.dic"); LDicomDS DicomDS; DicomDS.LoadDS(szFile, 0); pDICOMELEMENT pElement = DicomDS.FindFirstElement(NULL, TAG_SOP_INSTANCE_UID, FALSE); CString strInstance = DicomDS.GetStringValue(pElement, 0, 1); this->m_nDataCommand = COMMAND_C_MOVE; //the following will cause a ReceiveCStoreResponse event on this machine SendCStoreRequest( nPresentationID, nMessageID+ 1, pszClass, (L_TCHAR *)(LPCTSTR)strInstance, nPriority, pszMoveAE, nMessageID, &DicomDS); strMsg += TEXT("SendCStoreRequest\n"); AfxMessageBox(strMsg); //Server sends a CMove-Response after receiving the CStoreResponse from the calling AE }