ImageGear Professional for Unix
MED_DCM_DS_curr_data_set
| ImageGear Professional v18.2 > API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Functions > MED_DCM_DS_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_DCM_DS_curr_data_set(
HIGEAR hIGear,
const LPVOID lpData,
const DWORD size_of_data
);
|
|
| Name | Type | Description |
| hIGear | HIGEAR | HIGEAR handle of the image. |
| 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 | const 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 image must have a DICOM DataSet attached to it. Use MED_DCM_DS_exists to check whether the image contains a DataSet. |
The Data must be of the correct data type to match the Value Representation (VR) of the Current DE. You can use MED_DCM_DS_curr_info_get()to find out the VR of the Current DE, and you can use one of the MED_DCM_DS_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.