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

This function gets the preamble item from the Part 10 header of the image, if one exists.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_DCM_DS_preamble_get(
        const HIGEAR hIGear, 
        LPCHAR* lpPreamble
);

Arguments:

Name Type Description
hIGear const HIGEAR HIGEAR handle to the image.
lpPreamble LPCHAR* A far pointer to a buffer that will be used to hold the data from the preamble. The buffer must be at least 128 bytes.

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:

Your receiving buffer must be at least 128 bytes.