CONFORMANCECALLBACK

Summary

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

Syntax

#include "ltdic.h"

L_BOOL pEXT_CALLBACK YourFunction(pElement, nFlags, pUserData)

Parameters

pDICOMELEMENT pElement

A DICOM handle.

L_UINT16 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.

L_VOID * 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 L_DicomConformanceDS function.)

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

Returns

Value Meaning
TRUE The Data Set conforms to the standard.
FALSE The Data Set does not conforms to the standard.

Comments

The L_DicomConformanceDS 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.

Required DLLs and Libraries

Platforms

Win32, x64

Example

For and example, refer to L_DicomConformanceDS.

Help Version 22.0.2022.12.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.