ImageGear for C and C++ on Windows v19.6 - Updated
MED_DCM_DS_copy_get
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Functions > MED_DCM_DS_copy_get

This function allocates a new Element List and copies contents of the Data Set associated with HIGEAR to it.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_DCM_DS_copy_get(
       HIGEAR hIGear,
       HIGMEDELEMLIST* lphDstList);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to an image from which the Element List will be copied.
lphDstList HIGMEDELEMLIST* Address of the HIGMEDELEMLIST handle to the Data Element List 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:

When the copied Element List is no longer necessary, it should be destroyed by calling MED_ElemList_destroy().