CONFORMANCECALLBACK Function

#include "ltdic.h"

L_BOOL pEXT_CALLBACK YourFunction(pElement, nFlags, pUserData)

pDICOMELEMENT pElement;

/* a DICOM handle */

L_UINT16 nFlags;

/* flag that indicates any errors */

L_VOID * pUserData;

/* pointer to additional data */

Processes each Data Element of the Data Set to determine conformance.

Parameter

Description

pElement

A DICOM handle.

nFlags

Flag that indicates errors associated with the Data Element. Possible values are given below and may be combined using the bitwise OR ( | ) operator.

 

Value

Meaning

 

CALLBACK_ERROR_UNKNOWN_CLASS

[0x0001] Error- improper class code.

 

CALLBACK_ERROR_UNKNOWN_TAG

[0x0002] Error - improper tag value.

 

CALLBACK_ERROR_UNKNOWN_VR

[0x0004] Error - unknown Value Representation code.

 

CALLBACK_ERROR_WRONG_VR

[0x0008] Error - incorrect Value Representation code.

 

CALLBACK_ERROR_MIN_VM

[0x0010] Error - improper minimum value multiplicity value.

 

CALLBACK_ERROR_MAX_VM

[0x0020] Error - improper maximum value multiplicity value.

 

CALLBACK_ERROR_DIVIDE_VM

[0x0040] Error - improper value multiplicity divisor.

 

CALLBACK_ERROR_IMAGE

[0x0080] Error - improper image.

 

CALLBACK_ERROR_ELEMENT

[0x0100] Error - improper element or element length.

 

CALLBACK_ERROR_ELEMENT_EXISTS

[0x0200] Error - element already exists.

 

CALLBACK_ERROR_MEMORY

[0x0400] Error - out of memory.

pUserData

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. (This is the same pointer that you pass in the pUserData parameter of the LDicomDS::ConformanceDS function.)

 

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

Returns

TRUE

The Data Set comforms to the standard.

FALSE

The Data Set does not comform to the standard.

Comments

The LDicomDS::ConformanceDS function calls your callback function to verify each Data Element in the DataSet.

The purpose of this callback function is just to verify that the data provided in the Data Set conforms to the standard.

Set nFlags with the appropriate error message for any inconsistency encountered. For example, if a Data Element has a Value Representation of VR_FD (Floating Point Double) and the Value Field has an integer value, set the CALLBACK_ERROR_VR error in nFlags and return False.

Example

For an example, refer to LDicomDS::ConformanceDS.