MODALIZER SDK  3.2.2.2
DICOM Storage SCU

Functions

HRESULT IDCXREQ::Send ([in] BSTR callingTitle, [in] BSTR calledTitle, [in] BSTR host, [in] unsigned short port, [in] BSTR fileList, [out] BSTR *succeededFilesList, [out] BSTR *failedFilesList)
 send one or more files over network connection using DICOM C-STORE commands. More...
 
HRESULT IDCXREQ::SendObject ([in] BSTR callingTitle, [in] BSTR calledTitle, [in] BSTR host, [in] unsigned short port, [in] IDCXOBJ *obj)
 Send a DICOM Object Use the Send command to implement a C-STORE SCU. The SendObject command accepts a DCXOBJ. It goes over the object and check the SOP Classes and Transfer Syntaxes that should be negotiated in the Association. Then it initiates an Assocaition and sends the object. More...
 
HRESULT rzdcxLib::IDCXREQEvents::OnFileSent (VARIANT_BOOL succeeded, BSTR filename)
 Called by Send after sending each file. More...
 

Detailed Description

Function Documentation

◆ OnFileSent()

HRESULT rzdcxLib::IDCXREQEvents::OnFileSent ( VARIANT_BOOL  succeeded,
BSTR  filename 
)

Called by Send after sending each file.

Parameters
succeededTrue if the file was sent successfuly.
filenameThe file that was sent

◆ Send()

HRESULT IDCXREQ::Send ( [in] BSTR  callingTitle,
[in] BSTR  calledTitle,
[in] BSTR  host,
[in] unsigned short  port,
[in] BSTR  fileList,
[out] BSTR *  succeededFilesList,
[out] BSTR *  failedFilesList 
)

send one or more files over network connection using DICOM C-STORE commands.

Use the Send command to implement a C-STORE SCU. The send command accept a list of files to send. It goes over the files and check the SOP Classes and Transfer Syntaxes that should be negotiated in the Association. Then it initiates an Assocaition and sends the files.

DICOM Conformance:
  • Requested Presentation Contexts:
    • Verification SOP Class 1.2.840.10008.1.1
    • All the SOP classes of the files in filesList (parameter #5)
  • Proposed Transfer Syntaxes:
    • For SOP classes of files from filesList that are stored in one of the non-compressed (LEI, LEE and BEE) LEI, LEE and BEE are proposed.
    • For SOP classess of compressed files from filesList, the file's transfer syntax is requested.
    • If two files in the list have the same SOP Class, one is compressed (e.g. lossless JPEG) and another is one of the non-compressed, then two presentation contexts are negotiated, one with LEI, LEE and BEE and one with the compressed transfered syntax.
Parameters
callingTitleCalling AE Title (us)
calledTitleCalled AE Title (them)
hostHost name or IP address (their)
portThe port number they are listening to,
fileListA list of full path filenames to send. Use ; (semicolun) as a separator
succeededFilesListThe list of files that were send successfully
failedFilesListThe list of files that were not sent due to some error

◆ SendObject()

HRESULT IDCXREQ::SendObject ( [in] BSTR  callingTitle,
[in] BSTR  calledTitle,
[in] BSTR  host,
[in] unsigned short  port,
[in] IDCXOBJ obj 
)

Send a DICOM Object Use the Send command to implement a C-STORE SCU. The SendObject command accepts a DCXOBJ. It goes over the object and check the SOP Classes and Transfer Syntaxes that should be negotiated in the Association. Then it initiates an Assocaition and sends the object.

See also
Send
DICOM Conformance:
  • Requested Presentation Contexts:
    • Verification SOP Class 1.2.840.10008.1.1
    • The SOP class of the object from element (0008,0016)
  • Proposed Transfer Syntaxes:
    • If object was compressed, the compressed transfer syntax is proposed, otherwise all uncompressed transfer syntaxes (LEE, LEI and BEE) are proposed.
Parameters
callingTitleCalling AE Title (us)
calledTitleCalled AE Title (them)
hostHost name or IP address (their)
portThe port number they are listening to,
objThe object to send