ImageGear for C and C++ on Windows v19.0
MED_ElemList_curr_data_set
| API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Element List Functions > MED_ElemList_curr_data_set |
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.
|
Copy Code
|
|
|---|---|
AT_ERRCOUNT ACCUAPI MED_ElemList_curr_data_set(
HIGMEDELEMLIST hIGMedElemList,
const LPVOID lpData,
DWORD size_of_data
);
|
|
| 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. |
Returns the number of ImageGear errors that occurred during the function call.
This function does not process image pixels.
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.