LEADTOOLS DICOM C DLL Help > Callback Functions > 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_UCHAR * 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 PACS Imaging.
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 |
Win32, x64
See Also
Topics: |
Example
For an example, refer to L_DicomListen.