ImageGear Professional DLL v18.1 for Windows
MED_ElemList_curr_data_set
Send Feedback
ImageGear Professional v18.1 > API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Element List Functions > MED_ElemList_curr_data_set

Glossary Item Box

This function allows you to overwrite the Value Field (data) of the Current Data Element by copying the data from your buffer to the HDS table.

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI MED_ElemList_curr_data_set(
        HIGMEDELEMLIST hIGMedElemList, 
        const LPVOID lpData, 
        DWORD size_of_data
);

Arguments:

Name Type Description
hIGMedElemList HIGMEDELEMLIST HIGMEDELEMLIST handle to the Data Element List object.
lpData const LPVOID A far pointer of type VOID. Set this to the data you would like stored into the Data Field of the Current Data Element.
size_of_data DWORD Set this DWORD variable to the size of the data in lpData.

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:

The Data must be of the correct data type to match the Value Representation (VR) of the Current DE. You can use MED_ElemList_curr_info_get()to find out the VR of the Current DE, and you can use one of the _move_...() functions to set the Current Data Element.

If the Data Value can accept multiple Data Elements, the data values should be set as a single block of memory. To query the Value Multiplicity (VM) use MED_DCM_util_tag_info_get().

The length of a DICOM Data Field must always be an even number. If you set the size_of_lpData to an odd number of bytes, ImageGear will pad it (and your data) to make it an even-numbered length.

An error is set if the data type does not match the VR of the Current DE.

©2014. Accusoft Corporation. All Rights Reserved.