ImageGear for C and C++ on Windows v19.1 - Updated
MED_DCM_DS_part10_get
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Functions > MED_DCM_DS_part10_get

This function returns the data from the item in the Part 10 header identified by part10_item.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_DCM_DS_part10_get(
        const HIGEAR hIGear, 
        const AT_MODE part10_item, 
        const DWORD size_of_lpData, 
        LPVOID lpData, 
        LPDWORD lpSize_of_item
);

Arguments:

Name Type Description
hIGear const HIGEAR HIGEAR handle to the image.
part10_item const AT_MODE Set to the item in Part 10 that you would like to get. Use one of the AT_MODE constants defined in DCM.h that begin with DCM_PART10_ITEM_SET_.
size_of_lpData const DWORD Set to the size of the buffer lpData that you allocate to receive the data. This function will not copy more than this amount of data from the Part 10 Header, stored in the HIGEAR, to this buffer.
lpData LPVOID A far pointer to a VOID buffer in which return the data from the item specified by part10_item.
lpSize_of_Item LPDWORD A far pointer that returns the actual size of the Data Value that is stored in the Part 10 Header. It is not always the size of the data being returned in lpData. If this parameter returns a value greater than size_of_lpData then lpData does not contain all of the data-some has been clipped.

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.

Example:

 
Copy Code
#define BUFF_SIZE                        150
HIGEAR                  hIGear;
char                   data[BUFF_SIZE];
MED_DCM_DS_part10_get(g_hIGear, DCM_PART10_ITEM_PREAMBLE, BUFF_SIZE, data, &size_of_data);