MED_DCM_util_tag_info

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.

If lpVM returns a Positive integer: there must be this number of Items.
If it returns a 0: you may have an unlimited number of items, including 0.
If it returns a Negative integer: The number of items may include up to the absolute value of the value returned. For example, if lpVM = -3, you may have up to 3 items.