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

This function returns the data (Value Field) of the Current Data Element in its native form.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_DCM_DS_curr_data_get(
       const HIGEAR hIGear, 
       LPVOID lpData, 
       const DWORD size_of_lpData, 
       LPAT_DCM_VL lpActualSize);

Arguments:

Name Type Description
hIGear const HIGEAR HIGEAR handle to the image from which to get data.
lpData LPVOID A far pointer to a VOID buffer into which the data will be copied.
size_of_lpData const DWORD Size of above buffer, lpData.
lpActualSize LPAT_DCM_VL Actual number of bytes copied to lpData (NULL if inconsequential). This will always be equal to or smaller than size_of_lpData. If lpActualSize is less than the VL of the current Data Element then lpData does not contain all the data because lpData does not point to enough memory to hold the entire object.

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:

Each Data Element can be of one of many different data types (int, word, bytes, float, double, string, etc.) You must know the VR (Value Representation) of the data in order to use this data. To get the VR and the VL (Value Length), you can use one of the MED_DCM_DS_move_...() functions or MED_DCM_DS_curr_info_get(). Each time you move the Current Data Element with a _move_...() function, the VR and VL of the new Current Data Element are returned to you.

To retrieve the data as a string use MED_DCM_DS_curr_data_get_string().

Some VRs depend on the byte order of your operating system (Big Endian or Little Endian ) and the Transfer Syntax of the DICOM file. Examples of such VRs are: WORD, LONG, FLOAT, DOUBLE, etc. The Data Field values will be returned to you already adjusted to the proper format and no byte-swapping is needed.