MED_DCM_util_tag_info_add
This function allows you to add new entries into an internal table of Tag entries.
Declaration:
|
Copy Code
|
BOOL ACCUAPI MED_DCM_util_tag_info_add(
const AT_DCM_TAG Tag,
const AT_DCM_VR VR,
const AT_DCM_VM VM,
const WORD wVersion,
const 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. Group and Element are expressed as WORDs. |
lpVR |
const AT_DCM_VR |
Set to the VR of the new Tag. See enumIGMedVR for possible VR values. |
lpVM |
const AT_DCM_VM |
Set to the VM of the new Tag. Value Multiplicity tells whether and/or how many items can be stored in this type of Data Element. See Remarks below. |
wVersion |
const WORD |
Set this to the DICOM version. This should identify the first version of DICOM that includes this Tag. Most applications should set this to 3 but any value is accepted. |
LpszTagName |
const LPCHAR |
Set to a character string name that should be provided as the description of this Tag. |
Return Value:
Returns TRUE if the new Tag was successfully added to the Data Dictionary; FALSE otherwise.
Supported Raster Image Formats:
This function does not process image pixels.
Remarks:
It can be used for adding newly defined DICOM Tags (new to the specification) or for adding private user-defined Tags. Once a new entry is added, the new Tag works just like all other Tags do.
- Set VM to a non-zero positive integer for a Tag which must contain a specific number of Items.
- Set VM to 0 for a Tag which can have an unlimited number of Items.
- Set VM to a negative integer for a Tag which can have a limited number of items up to the absolute value of the provided VM. For example, VM = -3 means that the Tag may have up to 3 items.