ImageGear for C and C++ on Windows v19.1 - Updated
MED_DCM_util_VR_info_mode
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Utility Functions > MED_DCM_util_VR_info_mode

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.