ImageGear for C and C++ on Linux v19.10 - Updated
MED_DCM_DS_curr_info_get
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Functions > MED_DCM_DS_curr_info_get

This function returns information about the Current Data Element (DE).

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_DCM_DS_curr_info_get(
       const HIGEAR hIGear,
       LPAT_DCM_TAG lpTag, 
       LPAT_DCM_VR lpVR, 
       LPAT_DCM_VL lpVL, 
       LPWORD lpLevel, 
       LPDWORD lpItem_count
);

Arguments:

Name Type Description
hIGear const HIGEAR HIGEAR handle to the image.
lpTag LPAT_DCM_TAG A far pointer that returns a 32-bit value of type AT_DCM_TAG indicating the numerical value of the Tag of the Current Data Element; set this to NULL if you do not need this information. The numerical values of the DICOM Tags are defined in the enumIGMedTag enumeration.
lpVR LPAT_DCM_VR A far pointer to variable of type AT_DCM_VR which returns the Value Representation (VR) of the Current Data Element; set this to NULL if you do not need this information. See enumIGMedVR for possible VR values.
lpVL LPAT_DCM_VL A far pointer to a variable of type DWORD that returns the length, in bytes, of the Current Data Element's Data Field; set this to NULL if you do not need this information.
lpLevel LPWORD A far pointer to a WORD which returns the level in the hierarchy of the new Current Data Element; set to NULL if you do not need this information.
lpItem_count LPDWORD A far pointer that returns the number of items stored in the Data Field; set this to NULL if you do not need this information.

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.

The image must have a DICOM DataSet attached to it. Use MED_DCM_DS_exists to check whether the image contains a DataSet.

Remarks:

This function operates in just the same way as the MED_DCM_move_...() functions, except that it does not change the Current DE - it only reports about it.