SENDCALLBACK

#include "ltdic.h"

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

HDICOMNET hNet;

/* a DICOM Network handle */

L_INT nError;

/* error code */

L_UCHAR nType;

/* type of message/data sent */

L_UINT32 nBytes;

/* number of bytes of data sent */

L_VOID * UserData;

/* pointer to additional data */

Notifies a connection that data was sent. 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.

nBytes

Number of bytes of data actually sent.

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

When one of the L_DicomSendXXX functions is called, the message is not sent immediately. It is placed in a Network queue and sent later. When the data is actually sent, this callback function is called to let the calling AE know that the data has been sent.

To use this callback function, SENDCALLBACK must be set using L_DicomSetCallback.

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

Functions:

L_DicomSetCallback, L_DicomSendCCancelRequest, L_DicomSendCEchoRequest, L_DicomSendCEchoResponse, L_DicomSendCFindRequest, L_DicomSendCFindResponse, L_DicomSendCGetRequest, L_DicomSendCGetResponse, L_DicomSendCMoveRequest, L_DicomSendCMoveResponse, L_DicomSendCStoreRequest, L_DicomSendCStoreResponse, L_DicomSendNReportRequest, L_DicomSendNReportResponse, L_DicomSendNGetRequest, L_DicomSendNGetResponse, L_DicomSendNSetRequest, L_DicomSendNSetResponse, L_DicomSendNActionRequest, L_DicomSendNActionResponse, L_DicomSendNCreateRequest, L_DicomSendNCreateResponse, L_DicomSendNDeleteRequest, L_DicomSendNDeleteResponse

Topics:

Sending Messages

Example

For an example, refer to L_DicomListen.