ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / MD Component API Reference / MD Component Functions Reference / Data Set Element List Functions / MED_ElemList_curr_info_get
In This Topic
    MED_ElemList_curr_info_get
    In This Topic

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

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI MED_ElemList_curr_info_get(
            HIGMEDELEMLIST hIGMedElemList,
            LPAT_DCM_TAG lpTag, 
            LPAT_DCM_VR lpVR, 
            LPAT_DCM_VL lpVL, 
            LPWORD lpLevel, 
            LPDWORD lpItem_count
    );
    

    Arguments:

    Name Type Description
    hIGMedElemList HIGMEDELEMLIST HIGMEDELEMLIST handle to the Data Element List object.
    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 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.
    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.

    Remarks:

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