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.