ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / MD Component API Reference / MD Component Functions Reference / Data Set Functions / MED_DCM_DS_preamble_get
In This Topic
    MED_DCM_DS_preamble_get
    In This Topic

    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.