Receiving Messages

LEADTOOLS provides high-level and low-level functions for receiving messages and handling the associated data. The high-level functions take the received message and data and parse the required information, making it readily available to you. The low-level functions let you receive the raw data and process that data as you wish.

There are two low-level functions provided by LEADTOOLS, LDicomNet::OnReceive and LDicomNet::OnReceiveData. A call to the LDicomNet::OnReceive function is generated prior to the generation of all the LDicomNet::OnReceivexxx functions provided. A call to the LDicomNet::OnReceiveData function is generated prior to the LDicomNet::OnReceiveCxxx and LDicomNet::OnReceiveNxxx functions.

For example, when an SCU calls LDicomNet::SendCStoreRequest, calls to LDicomNet::OnReceive, LDicomNet::OnReceiveData, and LDicomNet::OnReceiveCStoreRequest are all generated on the SCP. The LDicomNet::OnReceiveCStoreRequest function parses the received data into readily useable form. The LDicomNet::OnReceive and LDicomNet::OnReceiveData provide the message and data in raw form so you can process the information yourself.

When an SCU calls LDicomNet::SendReleaseRequest, only calls to LDicomNet::OnReceive and LDicomNet::OnReceiveReleaseRequest are generated (A call to LDicomNet::OnReceiveData is not generated.) since there is no data being sent.