ImageGear for C and C++ on Windows v19.1 - Updated
MED_DCM_util_tag_info_get
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Utility Functions > MED_DCM_util_tag_info_get

This function returns information about the specified Tag.

Declaration:

 
Copy Code
BOOL ACCUAPI MED_DCM_util_tag_info_get(
        const AT_DCM_TAG Tag, 
        LPAT_DCM_VR lpVR, 
        LPAT_DCM_VM lpVM, 
        LPWORD lpwVersion, 
        LPCHAR lpszTagName
);

Arguments:

Name Type Description
Tag const AT_DCM_TAG Set to a Tag value. The Tag must be supplied as a 32-bit value in which the first 16 bits (WORD) represent the Group Number and the second 16 bits represent the Element Number. 
lpVR LPAT_DCM_VR A far pointer which returns the current VR (Value Representation). Set to NULL if you don't need this information. See enumIGMedVR for possible VR values.
lpVM LPAT_DCM_VM A far pointer which returns the VM (Value Multiplicity ) of the current Tag; set to NULL if you don't need this information. Value Multiplicity tells you whether and/or how many items can be stored in this type of Data Element. See Remarks below.
lpwVersion LPWORD Returns the version of DICOM Specification, such as 3.0.
lpszTagName LPCHAR Returns the name of the specified Tag.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

It returns the Value Representation, Value Multiplicity, DICOM version, and the Tag name. The function searches in the user-defined Data Dictionary first, and then if the Tag is not found, searches in the static Data Dictionary, which represents the Data Dictionary listed in Part 6 of the DICOM standard.

You might use this function before making a call that alters a Data Element.