This function returns information about the Current Data Element (DE).
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI MED_DCM_DS_curr_info_get(
const HIGEAR hIGear,
LPAT_DCM_TAG lpTag,
LPAT_DCM_VR lpVR,
LPAT_DCM_VL lpVL,
LPWORD lpLevel,
LPDWORD lpItem_count
);
|
|
Arguments:
| Name | Type | Description |
| hIGear | const HIGEAR | HIGEAR handle to the image. |
| lpTag | LPAT_DCM_TAG | A far pointer that returns a 32-bit value of type AT_DCM_TAG indicating the numerical value of the Tag of the Current Data Element; set this to NULL if you do not need this information. The numerical values of the DICOM Tags are defined in the enumIGMedTag enumeration. |
| lpVR | LPAT_DCM_VR | A far pointer to variable of type AT_DCM_VR which returns the Value Representation (VR) of the Current Data Element; set this to NULL if you do not need this information. See enumIGMedVR for possible VR values. |
| lpVL | LPAT_DCM_VL | A far pointer to a variable of type DWORD that returns the length, in bytes, of the Current Data Element's Data Field; set this to NULL if you do not need this information. |
| lpLevel | LPWORD | A far pointer to a WORD which returns the level in the hierarchy of the new Current Data Element; set to NULL if you do not need this information. |
| lpItem_count | LPDWORD | A far pointer that returns the number of items stored in the Data Field; set this to NULL if you do not need this information. |
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:
This function operates in just the same way as the MED_DCM_move_...() functions, except that it does not change the Current DE - it only reports about it.