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:
| 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 | Set to the VR of the new Tag. See enumIGMedVR for possible VR values. |
| lpVM | 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 | 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 | 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.