RECEIVECALLBACK

#include "ltdic.h"

L_VOID pEXT_CALLBACK Your Function(hNet, nError, nType, pBuffer, nBytes, UserData)

HDICOMNET hNet;

/* a DICOM Network handle*/

L_INT nError;

/* error code */

L_UCHAR nType;

/* type of message/data received */

L_CHAR * pBuffer;

/* buffer */

L_UINT32 nBytes;

/* number of bytes in pBuffer */

L_VOID * UserData;

/* pointer to additional data */

Notifies a connection that data was received. This function is available in the Medical Suite Toolkit.

Parameter

Description

hNet

A DICOM Network handle.

nError

Error code. Refer to Return Codes.

nType

The type of data that was sent. Possible values are:

 

Value

Meaning

 

PDU_UNKNOWN

[0x00] Unknown data sent.

 

PDU_ASSOCIATE_REQUEST

[0x01] Associate Request message sent

 

PDU_ASSOCIATE_ACCEPT

[0x02] Associate Accept message sent

 

PDU_ASSOCIATE_REJECT

[0x03] Associate Reject message sent

 

PDU_DATA_TRANSFER

[0x04] Data transfer made.

 

PDU_RELEASE_REQUEST

[0x05] Release Request message sent

 

PDU_RELEASE_RESPONSE

[0x06] Release Response message sent

 

PDU_ABORT

[0x07] Abort message sent.

pBuffer

Buffer that contains all the data that was sent. This includes the command set and any associated data set.

nBytes

Number of bytes of data in pBuffer.

UserData

Void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function.

 

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

None.

Comments

This is a low level means of receiving DICOM messages and data. It allows you to process messages yourself, instead of using the high level message processing functions provided.

This callback function is generated for each L_DicomSendXXX or LDicomSendXXX function provided by LEADTOOLS.

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

Topics:

Receiving Messages

Example

For an example, refer to L_DicomListen.