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.