ImageGear Professional DLL v17.1 for Windows Accusoft
MED_DCM_DS_info_get
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Functions > MED_DCM_DS_info_get

Glossary Item Box

This function returns the number of Data Elements (DEs) associated with the Data Set of the HIGEAR image.

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI MED_DCM_DS_info_get(       const HIGEAR hIGear, 
       LPDWORD lpNumTags, 
       LPDWORD lpMaxLevel);

Arguments:

hIGear HIGEAR handle to an image.
lpNumTags A far pointer to a DWORD which returns the number of Data Elements (same as the number of Tags) associated with the image's Data Set.
lpMaxLevel A far pointer to a DWORD which returns the maximum SQ Level of the Data Set.

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:

You might use the number of DEs returned to set the limit on a loop that iterates through each Data Element in a Data Set. If the DataSet contains SQ (Sequence of Items) data elements, the function returns the total number of data elements, including data elements contained within sequences. If there are no SQ Data Elements, lpMaxLevel is set to 0.

©2012. Accusoft Corporation. All Rights Reserved.