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

    This function looks up the Value Representation specified in vr_mode and returns the following information about it: its text representation, length, restrictions, and whether or not it can be a NULL-terminated string.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI MED_DCM_util_VR_info_mode(
            const AT_DCM_VR vr_mode,
            LPCHAR lpVRstring, 
            LPWORD lpwLength, 
            LPWORD lpwRestriction, 
            LPBOOL lpCheck_form, 
            LPBOOL lpIsString
    );
    

    Arguments:

    Name Type Description
    vr_mode const AT_DCM_VR Set this to the type of VR (or data type) you would like information on. See enumIGMedVR for possible VR values.
    lpVRstring LPCHAR A far pointer that returns the text representation of VR in 3 characters.
    lpwLength LPWORD A far pointer that returns the size of the VR.
    lpwRestriction LPWORD A far pointer that returns any restriction flags. These will be returned as constants that are defined in enumIGMedVRRestriction and begin with MED_DCM_LEN_. 
    lpReserved LPBOOL This argument has not been implemented yet. Please set to NULL for now.
    lpIsString LPBOOL A far pointer to a BOOL value that tells you whether the data of this type of VR is a NULL-terminated string or not. If TRUE, data of this type is a NULL-terminated string and could be printed using the print format %s. If FALSE, the data is an integer or other binary data type.

    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.