MappInquireConnection

See also

User Guide:

C/C++ MILweb function reference JavaScript MILweb function reference Message mailboxes Monitoring configuration

Reference:

MfuncAllocId MfuncParam

Availability

Available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP/GPm

Available on Matrox Supersight

Function map

Examples

monitoringapplication.cpp
monitoringapplication.cs
webclient.cpp
webclientqt.cpp

Function Map

Table:

For specifying the application context

Parameter Associations

Table:	For inquiring about a DMIL monitoring configuration connection
+ combination:	For distinguishing between the different object types

Return value

Compilation information

Synopsis

Inquire about published MIL objects on a Distributed MIL publishing application.

Syntax

MIL_INT MappInquireConnection(

MIL_ID ContextAppId,	//in
MIL_INT64 InquireType,	//in
MIL_INT64 ControlFlag,	//in
MIL_INT64 ExtraFlag,	//in
void *UserVarPtr	//out

)

Description

This function inquires about the published MIL objects on a Distributed MIL publishing application. A monitoring application will use this function to generate a list of the published MIL objects on a publishing application. With this list, you can determine the MIL identifier of a specific MIL object. With this MIL identifier, you can perform any MIL operations on the MIL object that its permission level allows.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.

Parameters

This function is not supported on the selected boards.

Parameters

ContextAppId

Specifies the identifier of the application context to use.

For specifying the application context
Value	Description
M_DEFAULT	Specifies the current application context.
Application Context Identifier	Specifies the application context identifier. Typically specifying an application context identifier is used to specify a remote application on a remote computer. However, it can be used for a remote application on the local computer, or the current application. When you explicitly specify the current application, it is equivalent to specifying M_DEFAULT. (summarize) Specifies the application context identifier. (more details...)

InquireType

Specifies the type of Distributed MIL connection setting about which to inquire. This parameter can be set to one of the values below.

Note that display objects cannot be published, and so do not appear as a possible return value.

See the Parameter associations section for possible values that can be specified.

ControlFlag

Specifies an attribute of the inquire operation to perform.

If this parameter is not required for the inquire operation, it must be set to M_DEFAULT.

See the Parameter associations section for possible values that can be specified.

ExtraFlag

Specifies an attribute of the inquire operation to perform.

If this parameter is not required for the inquire operation, it must be set to M_DEFAULT.

When using a standard vector (std::vector) overload function in C++, you can pass M_DEFAULT to this parameter and MIL will automatically determine the size based on the number of items in the vector passed to the parameter.

See the Parameter associations section for possible values that can be specified.

UserVarPtr

Accepts the address of one of the following (see the Parameter associations section for specifics on which is expected):

array of type MIL_ID [optionally, in C++: a reference to a std::vector<MIL_ID> ]
MIL_ID
MIL_INT64

Specifies the address in which to write the requested information. Since the MappInquireConnection() function also returns the requested information, you can set this parameter to M_NULL.

See the Parameter associations section for possible values that can be returned.

Parameter associations

The table below lists possible values for the InquireType, ControlFlag, and ExtraFlag parameters and possible values returned to the UserVarPtr parameter.

For inquiring about a DMIL monitoring configuration connection

Set unused parameters to M_DEFAULT.

For inquiring about a DMIL monitoring configuration connection

InquireType

Description

ControlFlag

ExtraFlag

UserVarPtr
- Possible values returned

M_DMIL_PUBLISHED_LIST

Inquires the list of MIL identifiers associated with the published MIL objects in a Distributed MIL publishing application.

Published MIL objects are those MIL objects set to read or read/write.

(summarize)

Inquires the list of MIL identifiers associated with the published MIL objects in a Distributed MIL publishing application.

(more details...)

ControlFlag

Specifies to limit the returned list from all MIL objects to all MIL objects of the specified MIL object type.

Note that a display object cannot be published, and so is not a possible object type with which to limit the returned list.

(summarize)

Specifies to limit the returned list from all MIL objects to all MIL objects of the specified MIL object type.

(more details...)

M_DEFAULT

Specifies to include all MIL object types in the Distributed MIL publishing application.

M_3D_DISPLAY

Specifies a MIL 3D display allocated using M3ddispAlloc().

M_3D_GRAPHIC_LIST

Specifies a MIL 3D graphics list allocated using M3dgraAlloc().

M_3DGEO_GEOMETRY

Specifies a MIL 3D geometry object allocated using M3dgeoAlloc() with M_GEOMETRY.

M_3DGEO_TRANSFORMATION_MATRIX

Specifies a MIL 3D transformation matrix object allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX.

M_3DIM_CALCULATE_MAP_SIZE_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimCalculateMapSize(), allocated using M3dimAlloc() with M_CALCULATE_MAP_SIZE_CONTEXT.

M_3DIM_FILL_GAPS_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimFillGaps(), allocated using M3dimAlloc() with M_FILL_GAPS_CONTEXT.

M_3DIM_MESH_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimMesh(), allocated using M3dimAlloc() with M_MESH_CONTEXT.

M_3DIM_NORMALS_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimNormals(), allocated using M3dimAlloc() with M_NORMALS_CONTEXT.

M_3DIM_PROFILE_RESULT

Specifies a MIL 3D image processing result buffer for profile results, allocated using M3dimAllocResult() with M_PROFILE_RESULT.

M_3DIM_STATISTICS_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimStat(), allocated using M3dimAlloc() with M_STATISTICS_CONTEXT.

M_3DIM_STATISTICS_RESULT

Specifies a MIL 3D image processing result buffer used to store M3dimStat() results, and is allocated using M3dimAllocResult() with M_STATISTICS_RESULT.

M_3DIM_SUBSAMPLE_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimSample(), allocated using M3dimAlloc() with M_SUBSAMPLE_CONTEXT.

M_3DIM_SURFACE_SAMPLE_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimSample(), allocated using M3dimAlloc() with M_SURFACE_SAMPLE_CONTEXT.

M_3DMAP_DEPTH_CORRECTED_DATA

Specifies a MIL 3D reconstruction result buffer allocated using M3dmapAllocResult() with M_DEPTH_CORRECTED_DATA.

M_3DMAP_DRAW_3D_CONTEXT

Specifies a MIL 3D draw context allocated using M3dmapAlloc() with M_DRAW_3D_CONTEXT.

M_3DMAP_LASER_CALIBRATION_DATA

Specifies a MIL 3D reconstruction result buffer allocated using M3dmapAllocResult() with M_LASER_CALIBRATION_DATA.

M_3DMAP_LASER_CONTEXT

Specifies a MIL 3D reconstruction context allocated using M3dmapAlloc() with M_LASER.

M_3DMAP_POINT_CLOUD_RESULT

Specifies a MIL 3D reconstruction result buffer allocated using M3dmapAllocResult() with M_POINT_CLOUD_RESULT.

M_3DMET_FIT_CONTEXT

Specifies a MIL fit 3D metrology context allocated using M3dmetAlloc() with M_FIT_CONTEXT.

M_3DMET_FIT_RESULT

Specifies a MIL fit 3D metrology result buffer allocated using M3dmetAllocResult() with M_FIT_RESULT.

M_3DMET_STATISTICS_CONTEXT

Specifies a MIL statistics 3D metrology context allocated using M3dmetAlloc() with M_STATISTICS_CONTEXT.

M_3DMET_STATISTICS_RESULT

Specifies a MIL statistics 3D metrology result buffer allocated using M3dmetAllocResult() with M_STATISTICS_RESULT.

M_3DREG_PAIRWISE_REGISTRATION_CONTEXT

Specifies a MIL pairwise 3D registration context allocated using M3dregAlloc() with M_PAIRWISE_REGISTRATION_CONTEXT.

M_3DREG_PAIRWISE_REGISTRATION_RESULT

Specifies a MIL pairwise 3D registration result buffer allocated using M3dregAllocResult() with M_PAIRWISE_REGISTRATION_RESULT.

M_APPLICATION

Specifies a MIL application context allocated using MappAlloc().

M_ARRAY

Specifies a MIL array buffer allocated using MbufAlloc2d() with M_ARRAY.

M_AUGMENTATION_RESULT

Specifies a MIL augmentation result buffer allocated using MimAllocResult() with M_AUGMENTATION_RESULT.

M_BEAD_CONTEXT

Specifies a MIL bead context allocated using MbeadAlloc().

M_BEAD_RESULT

Specifies a MIL bead result buffer allocated using MbeadAllocResult().

M_BLOB_CONTEXT

Specifies a MIL blob analysis context allocated using MblobAlloc().

M_BLOB_RESULT

Specifies a MIL blob analysis result buffer allocated using MblobAllocResult().

M_CAL_CONTEXT

Specifies a MIL camera calibration context allocated using McalAlloc().

M_CAL_DRAW_3D_CONTEXT

Specifies a MIL 3D draw calibration context allocated using McalAlloc() with M_DRAW_3D_CONTEXT.

M_CAL_FIXTURING_OFFSET

Specifies a MIL fixturing offset object allocated using McalAlloc() with M_FIXTURING_OFFSET.

M_CLASS_CLASSIFIER_CNN_PREDEFINED_CONTEXT

Specifies a MIL predefined convolutional neural network context allocated using MclassAlloc().

M_CLASS_CLASSIFIER_TREE_ENSEMBLE_CONTEXT

Specifies a MIL tree ensemble classifier context allocated using MclassAlloc().

M_CLASS_DATASET_FEATURES

Specifies a MIL features dataset context allocated using MclassAlloc() with M_DATASET_FEATURES.

M_CLASS_DATASET_IMAGES

Specifies a MIL classification dataset allocated using MclassAlloc().

M_CLASS_PREDICT_CNN_RESULT

Specifies a MIL result buffer to hold the classification results performed with a predefined convolutional neural network context using MclassPredict(). INFO

M_CLASS_PREDICT_TREE_ENSEMBLE_RESULT

Specifies a MIL tree ensemble prediction result buffer, allocated using MclassAllocResult().

M_CLASS_TRAIN_CNN_CONTEXT

Specifies a MIL context to hold the training settings of a convolutional neural network training context allocated using MclassAlloc().

M_CLASS_TRAIN_CNN_RESULT

Specifies a MIL result buffer to hold the result of a call to MclassTrain().

M_CLASS_TRAIN_TREE_ENSEMBLE_CONTEXT

Specifies a MIL tree ensemble training context, allocated using MclassAlloc().

M_CLASS_TRAIN_TREE_ENSEMBLE_RESULT

Specifies a MIL tree ensemble training result buffer, allocated using MclassAlloc().

M_CODE_CONTEXT

Specifies a MIL code context allocated using McolAlloc().

M_CODE_DETECT_RESULT

Specifies a MIL code detect result buffer allocated using McodeAllocResult().

M_CODE_GRADE_RESULT

Specifies a MIL code grade result buffer allocated using McodeAllocResult().

M_CODE_MODEL

Specifies a MIL code model allocated using McodeModel() with M_ADD.

M_CODE_READ_RESULT

Specifies a MIL code read result buffer allocated using McodeAllocResult().

M_CODE_TRAIN_RESULT

Specifies a MIL code train result buffer allocated using McodeAllocResult().

M_CODE_WRITE_RESULT

Specifies a MIL code write result buffer allocated using McodeAllocResult().

M_COL_MATCH_CONTEXT

Specifies a MIL color analysis context (for matching) allocated using McolAlloc() with M_COLOR_MATCHING.

M_COL_MATCH_RESULT

Specifies a MIL color analysis result buffer (for matching) allocated using McolAllocResult() with M_COLOR_MATCHING_RESULT.

M_COL_RELATIVE_CALIBRATION_CONTEXT

Specifies a MIL relative color calibration context allocated using McolAlloc() with M_COLOR_CALIBRATION_RELATIVE.

M_COM_CONTEXT

Specifies a MIL industrial communication context allocated using McomAlloc().

M_CONTAINER

Specifies a MIL container buffer allocated using MbufAllocContainer().

M_COUNT_LIST

Specifies a MIL count list result buffer allocated using MimAllocResult() with M_COUNT_LIST.

M_DIGITIZER

Specifies a MIL digitizer allocated using MdigAlloc().

M_DMR_CONTEXT

Specifies a MIL SureDotOCR context allocated using MdmrAlloc().

M_DMR_RESULT

Specifies a MIL SureDotOCR result buffer allocated using MdmrAllocResult().

M_EDGE_CONTOUR

Specifies a MIL edge contour context allocated using MedgeAlloc() with M_CONTOUR.

M_EDGE_CREST

Specifies a MIL edge crest context allocated using MedgeAlloc() with M_CREST.

M_EDGE_RESULT

Specifies a MIL edge result buffer allocated using MedgeAllocResult().

M_EVENT

Specifies a MIL event allocated using MthrAlloc() with M_EVENT.

M_EVENT_LIST

Specifies a MIL event list result buffer allocated using MimAllocResult() with M_EVENT_LIST.

M_EXTREME_LIST

Specifies a MIL extreme list result buffer allocated using MimAllocResult() with M_EXTREME_LIST.

M_FIND_ORIENTATION_LIST

Specifies a MIL find orientation list result buffer allocated using MimAllocResult() with M_FIND_ORIENTATION_LIST.

M_GRAPHIC_CONTEXT

Specifies a MIL 2D graphics context allocated using MgraAlloc().

M_GRAPHIC_LIST

Specifies a MIL 2D graphics list allocated using MgraAllocList().

M_HIST_LIST

Specifies a MIL histogram list result buffer allocated using MimAllocResult() with M_HIST_LIST.

M_HTTP_SERVER

Specifies an HTTP server allocated using MobjAlloc() with M_HTTP_SERVER.

M_IM_CONTEXT

Specifies a MIL image processing context allocated using MimAlloc().

M_IMAGE

Specifies a MIL image buffer allocated using MbufAllocColor() with M_IMAGE.

M_KERNEL

Specifies a MIL kernel buffer allocated using MbufAlloc2d() with M_KERNEL.

M_LOCATE_PEAK_1D_RESULT

Specifies a MIL locate 1D peak result buffer allocated using MimAllocResult() with M_LOCATE_PEAK_1D_RESULT.

M_LUT

Specifies a MIL LUT buffer allocated using MbufAlloc2d() with M_LUT.

M_MEAS_CONTEXT

Specifies a MIL measurement context allocated using MmeasAllocContext().

M_MEAS_MARKER

Specifies a MIL measurement marker allocated using MmeasAllocMarker().

M_MEAS_RESULT

Specifies a MIL measurement result buffer allocated using MmeasAllocResult().

M_MESSAGE_MAILBOX

Specifies a MIL message mailbox allocated using MobjAlloc().

M_MET_CONTEXT

Specifies a MIL metrology context allocated using MmetAlloc() with M_CONTEXT.

M_MET_DERIVED_GEOMETRY_REGION

Specifies a MIL metrology derived geometry region object allocated using MmetAlloc() with M_DERIVED_GEOMETRY_REGION.

M_MET_RESULT

Specifies a MIL metrology result buffer allocated using MmetAllocResult().

M_MOD_GEOMETRIC

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_GEOMETRIC.

M_MOD_GEOMETRIC_CONTROLLED

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_GEOMETRIC_CONTROLLED.

M_MOD_RESULT

Specifies a MIL Model Finder result buffer allocated using MmodAllocResult() with M_DEFAULT.

M_MOD_SHAPE_CIRCLE_CONTEXT

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_SHAPE_CIRCLE.

M_MOD_SHAPE_ELLIPSE_CONTEXT

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_SHAPE_ELLIPSE.

M_MOD_SHAPE_RECTANGLE_CONTEXT

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_SHAPE_RECTANGLE.

M_MOD_SHAPE_RESULT

Specifies a MIL Model Finder result buffer allocated using MmodAllocResult() with M_SHAPE_CIRCLE or M_SHAPE_ELLIPSE.

M_MOD_SHAPE_SEGMENT_CONTEXT

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_SHAPE_SEGMENT.

M_MUTEX

Specifies a MIL mutex allocated using MthrAlloc() with M_MUTEX.

M_OCR_FONT

Specifies a MIL character recognition font context allocated using MocrAllocFont().

M_OCR_RESULT

Specifies a MIL character recognition result buffer allocated using MocrAllocResult().

M_PAT_CONTEXT

Specifies a MIL pattern matching context allocated using MpatAlloc().

M_PAT_RESULT

Specifies a MIL pattern matching result buffer allocated using MpatAllocResult().

M_PROJ_LIST

Specifies a MIL project list result buffer allocated using MimAllocResult() with M_PROJ_LIST.

M_REG_DFF_CONTEXT

Specifies a MIL registration context allocated using MregAlloc() with M_DEPTH_FROM_FOCUS.

M_REG_DFF_RESULT

Specifies a MIL registration result buffer allocated using MregAllocResult() with M_DEPTH_FROM_FOCUS_RESULT.

M_REG_EDOF_CONTEXT

Specifies a MIL registration context allocated using MregAlloc() with M_EXTENDED_DEPTH_OF_FIELD.

M_REG_EDOF_RESULT

Specifies a MIL registration result buffer allocated using MregAllocResult() with M_EXTENDED_DEPTH_OF_FIELD_RESULT.

M_REG_HDR_CONTEXT

Specifies a MIL registration context allocated using MregAlloc() with M_HIGH_DYNAMIC_RANGE.

M_REG_HDR_RESULT

Specifies a MIL registration result buffer allocated using MregAllocResult() with M_HIGH_DYNAMIC_RANGE_RESULT.

M_REG_PHOTOMETRIC_STEREO_CONTEXT

Specifies a MIL registration context allocated using MregAlloc() with M_PHOTOMETRIC_STEREO.

M_REG_PHOTOMETRIC_STEREO_RESULT

Specifies a MIL registration result buffer allocated using MregAllocResult() with M_PHOTOMETRIC_STEREO_RESULT.

M_REG_STITCHING_CONTEXT

Specifies a MIL registration context allocated using MregAlloc() with M_STITCHING.

M_REG_STITCHING_RESULT

Specifies a MIL registration result buffer allocated using MregAllocResult() with M_STITCHING_RESULT.

M_SELECTABLE_THREAD

Specifies a MIL selectable thread allocated using MthrAlloc() with M_SELECTABLE_THREAD.

M_SEQUENCE_CONTEXT

Specifies a MIL sequence context allocated using MseqAlloc().

M_STATISTICS_RESULT

Specifies a MIL MimStatCalculate() result buffer allocated using MimAllocResult() with M_STATISTICS_RESULT.

M_STR_CONTEXT

Specifies a MIL string context allocated using MstrAlloc().

M_STR_RESULT

Specifies a MIL string result buffer allocated using MstrAllocResult().

M_STRUCT_ELEMENT

Specifies a MIL structuring element buffer allocated using MbufAlloc2d() with M_STRUCT_ELEMENT.

M_SYS_IO_CONTEXT

Specifies a MIL system I/O context allocated using MsysIoAlloc().

M_SYSTEM

Specifies a MIL system context allocated using MsysAlloc().

M_SYSTEM_THREAD

Specifies a MIL thread allocated using MthrAlloc() with M_THREAD.

M_THREAD

Specifies a MIL thread context object allocated using MthrAlloc() with M_THREAD.

M_USER_OBJECT_1 +

Specifies a MIL object from group one of the user-defined object types allocated using MfuncAllocId() with M_USER_OBJECT_1.

You must specify a combination value from the following table:

To set the offset

(summarize)

Specifies a MIL object from group one of the user-defined object types allocated using MfuncAllocId() with M_USER_OBJECT_1.

(more details...)

M_USER_OBJECT_2 +

Specifies a MIL object from group two of the user-defined object types allocated using MfuncAllocId() with M_USER_OBJECT_2.

You must specify a combination value from the following table:

To set the offset

(summarize)

Specifies a MIL object from group two of the user-defined object types allocated using MfuncAllocId() with M_USER_OBJECT_2.

(more details...)

M_WAVELET_TRANSFORM_RESULT

Specifies a MIL wavelet transform result buffer allocated using MimAllocResult() with M_WAVELET_TRANSFORM_RESULT.

ExtraFlag

Specifies the size of the array.

If the current list of published MIL objects in the publishing application is smaller than the array size, the array will be populated with the MIL identifiers associated with all the MIL objects in the list, and the remaining elements will be populated with M_NULL.

If the current list of published MIL objects in the publishing application is larger than the array size, the array will be populated with the MIL identifiers associated with the first MIL objects it receives, and the remaining MIL identifiers on the list will be ignored.

(summarize)

Specifies the size of the array.

(more details...)

UserVarPtr

Data type info: Data type: array of type MIL_ID [optionally, in C++: a reference to a std::vector<MIL_ID> ] MORE

M_DMIL_PUBLISHED_LIST_SIZE

Inquires the current number of MIL objects published in a Distributed MIL publishing application.

(summarize)

Inquires the current number of MIL objects published in a Distributed MIL publishing application.

(more details...)

ControlFlag

Specifies to limit the count from all MIL objects to all MIL objects of the specified MIL object type.

Note that a display object cannot be published, and so is not a possible object type with which to limit the size of returned list.

(summarize)

Specifies to limit the count from all MIL objects to all MIL objects of the specified MIL object type.

(more details...)

M_DEFAULT

Specifies to count all MIL object types in the Distributed MIL publishing application.

M_3D_DISPLAY

Specifies a MIL 3D display allocated using M3ddispAlloc().

M_3D_GRAPHIC_LIST

Specifies a MIL 3D graphics list allocated using M3dgraAlloc().

M_3DGEO_GEOMETRY

Specifies a MIL 3D geometry object allocated using M3dgeoAlloc() with M_GEOMETRY.

M_3DGEO_TRANSFORMATION_MATRIX

Specifies a MIL 3D transformation matrix object allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX.

M_3DIM_CALCULATE_MAP_SIZE_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimCalculateMapSize(), allocated using M3dimAlloc() with M_CALCULATE_MAP_SIZE_CONTEXT.

M_3DIM_FILL_GAPS_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimFillGaps(), allocated using M3dimAlloc() with M_FILL_GAPS_CONTEXT.

M_3DIM_MESH_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimMesh(), allocated using M3dimAlloc() with M_MESH_CONTEXT.

M_3DIM_NORMALS_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimNormals(), allocated using M3dimAlloc() with M_NORMALS_CONTEXT.

M_3DIM_PROFILE_RESULT

Specifies a MIL 3D image processing result buffer for profile results, allocated using M3dimAllocResult() with M_PROFILE_RESULT.

M_3DIM_STATISTICS_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimStat(), allocated using M3dimAlloc() with M_STATISTICS_CONTEXT.

M_3DIM_STATISTICS_RESULT

Specifies a MIL 3D image processing result buffer used to store M3dimStat() results, and is allocated using M3dimAllocResult() with M_STATISTICS_RESULT.

M_3DIM_SUBSAMPLE_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimSample(), allocated using M3dimAlloc() with M_SUBSAMPLE_CONTEXT.

M_3DIM_SURFACE_SAMPLE_CONTEXT

Specifies a MIL 3D image processing context that can be used with M3dimSample(), allocated using M3dimAlloc() with M_SURFACE_SAMPLE_CONTEXT.

M_3DMAP_DEPTH_CORRECTED_DATA

Specifies a MIL 3D reconstruction result buffer allocated using M3dmapAllocResult() with M_DEPTH_CORRECTED_DATA.

M_3DMAP_DRAW_3D_CONTEXT

Specifies a MIL 3D draw context allocated using M3dmapAlloc() with M_DRAW_3D_CONTEXT.

M_3DMAP_LASER_CALIBRATION_DATA

Specifies a MIL 3D reconstruction result buffer allocated using M3dmapAllocResult() with M_LASER_CALIBRATION_DATA.

M_3DMAP_LASER_CONTEXT

Specifies a MIL 3D reconstruction context allocated using M3dmapAlloc() with M_LASER.

M_3DMAP_POINT_CLOUD_RESULT

Specifies a MIL 3D reconstruction result buffer allocated using M3dmapAllocResult() with M_POINT_CLOUD_RESULT.

M_3DMET_FIT_CONTEXT

Specifies a MIL fit 3D metrology context allocated using M3dmetAlloc() with M_FIT_CONTEXT.

M_3DMET_FIT_RESULT

Specifies a MIL fit 3D metrology result buffer allocated using M3dmetAllocResult() with M_FIT_RESULT.

M_3DMET_STATISTICS_CONTEXT

Specifies a MIL statistics 3D metrology context allocated using M3dmetAlloc() with M_STATISTICS_CONTEXT.

M_3DMET_STATISTICS_RESULT

Specifies a MIL statistics 3D metrology result buffer allocated using M3dmetAllocResult() with M_STATISTICS_RESULT.

M_3DREG_PAIRWISE_REGISTRATION_CONTEXT

Specifies a MIL pairwise 3D registration context allocated using M3dregAlloc() with M_PAIRWISE_REGISTRATION_CONTEXT.

M_3DREG_PAIRWISE_REGISTRATION_RESULT

Specifies a MIL pairwise 3D registration result buffer allocated using M3dregAllocResult() with M_PAIRWISE_REGISTRATION_RESULT.

M_APPLICATION

Specifies a MIL application context allocated using MappAlloc().

M_ARRAY

Specifies a MIL array buffer allocated using MbufAlloc2d() with M_ARRAY.

M_AUGMENTATION_RESULT

Specifies a MIL augmentation result buffer allocated using MimAllocResult() with M_AUGMENTATION_RESULT.

M_BEAD_CONTEXT

Specifies a MIL bead context allocated using MbeadAlloc().

M_BEAD_RESULT

Specifies a MIL bead result buffer allocated using MbeadAllocResult().

M_BLOB_CONTEXT

Specifies a MIL blob analysis context allocated using MblobAlloc().

M_BLOB_RESULT

Specifies a MIL blob analysis result buffer allocated using MblobAllocResult().

M_CAL_CONTEXT

Specifies a MIL camera calibration context allocated using McalAlloc().

M_CAL_DRAW_3D_CONTEXT

Specifies a MIL 3D draw calibration context allocated using McalAlloc() with M_DRAW_3D_CONTEXT.

M_CAL_FIXTURING_OFFSET

Specifies a MIL fixturing offset object allocated using McalAlloc() with M_FIXTURING_OFFSET.

M_CLASS_CLASSIFIER_CNN_PREDEFINED_CONTEXT

Specifies a MIL predefined convolutional neural network context allocated using MclassAlloc().

M_CLASS_CLASSIFIER_TREE_ENSEMBLE_CONTEXT

Specifies a MIL tree ensemble classifier context allocated using MclassAlloc().

M_CLASS_DATASET_FEATURES

Specifies a MIL features dataset context allocated using MclassAlloc() with M_DATASET_FEATURES.

M_CLASS_DATASET_IMAGES

Specifies a MIL classification dataset allocated using MclassAlloc().

M_CLASS_PREDICT_CNN_RESULT

Specifies a MIL result buffer to hold the classification results performed with a predefined convolutional neural network context using MclassPredict(). INFO

M_CLASS_PREDICT_TREE_ENSEMBLE_RESULT

Specifies a MIL tree ensemble prediction result buffer, allocated using MclassAllocResult().

M_CLASS_TRAIN_CNN_CONTEXT

Specifies a MIL context to hold the training settings of a convolutional neural network training context allocated using MclassAlloc().

M_CLASS_TRAIN_CNN_RESULT

Specifies a MIL result buffer to hold the result of a call to MclassTrain().

M_CLASS_TRAIN_TREE_ENSEMBLE_CONTEXT

Specifies a MIL tree ensemble training context, allocated using MclassAlloc().

M_CLASS_TRAIN_TREE_ENSEMBLE_RESULT

Specifies a MIL tree ensemble training result buffer, allocated using MclassAlloc().

M_CODE_CONTEXT

Specifies a MIL code context allocated using McolAlloc().

M_CODE_DETECT_RESULT

Specifies a MIL code detect result buffer allocated using McodeAllocResult().

M_CODE_GRADE_RESULT

Specifies a MIL code grade result buffer allocated using McodeAllocResult().

M_CODE_MODEL

Specifies a MIL code model allocated using McodeModel() with M_ADD.

M_CODE_READ_RESULT

Specifies a MIL code read result buffer allocated using McodeAllocResult().

M_CODE_TRAIN_RESULT

Specifies a MIL code train result buffer allocated using McodeAllocResult().

M_CODE_WRITE_RESULT

Specifies a MIL code write result buffer allocated using McodeAllocResult().

M_COL_MATCH_CONTEXT

Specifies a MIL color analysis context (for matching) allocated using McolAlloc() with M_COLOR_MATCHING.

M_COL_MATCH_RESULT

Specifies a MIL color analysis result buffer (for matching) allocated using McolAllocResult() with M_COLOR_MATCHING_RESULT.

M_COL_RELATIVE_CALIBRATION_CONTEXT

Specifies a MIL relative color calibration context allocated using McolAlloc() with M_COLOR_CALIBRATION_RELATIVE.

M_COM_CONTEXT

Specifies a MIL industrial communication context allocated using McomAlloc().

M_CONTAINER

Specifies a MIL container buffer allocated using MbufAllocContainer().

M_COUNT_LIST

Specifies a MIL count list result buffer allocated using MimAllocResult() with M_COUNT_LIST.

M_DIGITIZER

Specifies a MIL digitizer allocated using MdigAlloc().

M_DMR_CONTEXT

Specifies a MIL SureDotOCR context allocated using MdmrAlloc().

M_DMR_RESULT

Specifies a MIL SureDotOCR result buffer allocated using MdmrAllocResult().

M_EDGE_CONTOUR

Specifies a MIL edge contour context allocated using MedgeAlloc() with M_CONTOUR.

M_EDGE_CREST

Specifies a MIL edge crest context allocated using MedgeAlloc() with M_CREST.

M_EDGE_RESULT

Specifies a MIL edge result buffer allocated using MedgeAllocResult().

M_EVENT

Specifies a MIL event allocated using MthrAlloc() with M_EVENT.

M_EVENT_LIST

Specifies a MIL event list result buffer allocated using MimAllocResult() with M_EVENT_LIST.

M_EXTREME_LIST

Specifies a MIL extreme list result buffer allocated using MimAllocResult() with M_EXTREME_LIST.

M_FIND_ORIENTATION_LIST

Specifies a MIL find orientation list result buffer allocated using MimAllocResult() with M_FIND_ORIENTATION_LIST.

M_GRAPHIC_CONTEXT

Specifies a MIL 2D graphics context allocated using MgraAlloc().

M_GRAPHIC_LIST

Specifies a MIL 2D graphics list allocated using MgraAllocList().

M_HIST_LIST

Specifies a MIL histogram list result buffer allocated using MimAllocResult() with M_HIST_LIST.

M_HTTP_SERVER

Specifies an HTTP server allocated using MobjAlloc() with M_HTTP_SERVER.

M_IM_CONTEXT

Specifies a MIL image processing context allocated using MimAlloc().

M_IMAGE

Specifies a MIL image buffer allocated using MbufAllocColor() with M_IMAGE.

M_KERNEL

Specifies a MIL kernel buffer allocated using MbufAlloc2d() with M_KERNEL.

M_LOCATE_PEAK_1D_RESULT

Specifies a MIL locate 1D peak result buffer allocated using MimAllocResult() with M_LOCATE_PEAK_1D_RESULT.

M_LUT

Specifies a MIL LUT buffer allocated using MbufAlloc2d() with M_LUT.

M_MEAS_CONTEXT

Specifies a MIL measurement context allocated using MmeasAllocContext().

M_MEAS_MARKER

Specifies a MIL measurement marker allocated using MmeasAllocMarker().

M_MEAS_RESULT

Specifies a MIL measurement result buffer allocated using MmeasAllocResult().

M_MESSAGE_MAILBOX

Specifies a MIL message mailbox allocated using MobjAlloc().

M_MET_CONTEXT

Specifies a MIL metrology context allocated using MmetAlloc() with M_CONTEXT.

M_MET_DERIVED_GEOMETRY_REGION

Specifies a MIL metrology derived geometry region object allocated using MmetAlloc() with M_DERIVED_GEOMETRY_REGION.

M_MET_RESULT

Specifies a MIL metrology result buffer allocated using MmetAllocResult().

M_MOD_GEOMETRIC

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_GEOMETRIC.

M_MOD_GEOMETRIC_CONTROLLED

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_GEOMETRIC_CONTROLLED.

M_MOD_RESULT

Specifies a MIL Model Finder result buffer allocated using MmodAllocResult() with M_DEFAULT.

M_MOD_SHAPE_CIRCLE_CONTEXT

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_SHAPE_CIRCLE.

M_MOD_SHAPE_ELLIPSE_CONTEXT

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_SHAPE_ELLIPSE.

M_MOD_SHAPE_RECTANGLE_CONTEXT

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_SHAPE_RECTANGLE.

M_MOD_SHAPE_RESULT

Specifies a MIL Model Finder result buffer allocated using MmodAllocResult() with M_SHAPE_CIRCLE or M_SHAPE_ELLIPSE.

M_MOD_SHAPE_SEGMENT_CONTEXT

Specifies a MIL Model Finder context allocated using MmodAlloc() with M_SHAPE_SEGMENT.

M_MUTEX

Specifies a MIL mutex allocated using MthrAlloc() with M_MUTEX.

M_OCR_FONT

Specifies a MIL character recognition font context allocated using MocrAllocFont().

M_OCR_RESULT

Specifies a MIL character recognition result buffer allocated using MocrAllocResult().

M_PAT_CONTEXT

Specifies a MIL pattern matching context allocated using MpatAlloc().

M_PAT_RESULT

Specifies a MIL pattern matching result buffer allocated using MpatAllocResult().

M_PROJ_LIST

Specifies a MIL project list result buffer allocated using MimAllocResult() with M_PROJ_LIST.

M_REG_DFF_CONTEXT

Specifies a MIL registration context allocated using MregAlloc() with M_DEPTH_FROM_FOCUS.

M_REG_DFF_RESULT

Specifies a MIL registration result buffer allocated using MregAllocResult() with M_DEPTH_FROM_FOCUS_RESULT.

M_REG_EDOF_CONTEXT

Specifies a MIL registration context allocated using MregAlloc() with M_EXTENDED_DEPTH_OF_FIELD.

M_REG_EDOF_RESULT

Specifies a MIL registration result buffer allocated using MregAllocResult() with M_EXTENDED_DEPTH_OF_FIELD_RESULT.

M_REG_HDR_CONTEXT

Specifies a MIL registration context allocated using MregAlloc() with M_HIGH_DYNAMIC_RANGE.

M_REG_HDR_RESULT

Specifies a MIL registration result buffer allocated using MregAllocResult() with M_HIGH_DYNAMIC_RANGE_RESULT.

M_REG_PHOTOMETRIC_STEREO_CONTEXT

Specifies a MIL registration context allocated using MregAlloc() with M_PHOTOMETRIC_STEREO.

M_REG_PHOTOMETRIC_STEREO_RESULT

Specifies a MIL registration result buffer allocated using MregAllocResult() with M_PHOTOMETRIC_STEREO_RESULT.

M_REG_STITCHING_CONTEXT

Specifies a MIL registration context allocated using MregAlloc() with M_STITCHING.

M_REG_STITCHING_RESULT

Specifies a MIL registration result buffer allocated using MregAllocResult() with M_STITCHING_RESULT.

M_SELECTABLE_THREAD

Specifies a MIL selectable thread allocated using MthrAlloc() with M_SELECTABLE_THREAD.

M_SEQUENCE_CONTEXT

Specifies a MIL sequence context allocated using MseqAlloc().

M_STATISTICS_RESULT

Specifies a MIL MimStatCalculate() result buffer allocated using MimAllocResult() with M_STATISTICS_RESULT.

M_STR_CONTEXT

Specifies a MIL string context allocated using MstrAlloc().

M_STR_RESULT

Specifies a MIL string result buffer allocated using MstrAllocResult().

M_STRUCT_ELEMENT

Specifies a MIL structuring element buffer allocated using MbufAlloc2d() with M_STRUCT_ELEMENT.

M_SYS_IO_CONTEXT

Specifies a MIL system I/O context allocated using MsysIoAlloc().

M_SYSTEM

Specifies a MIL system context allocated using MsysAlloc().

M_SYSTEM_THREAD

Specifies a MIL thread allocated using MthrAlloc() with M_THREAD.

M_THREAD

Specifies a MIL thread context object allocated using MthrAlloc() with M_THREAD.

M_USER_OBJECT_1 +

Specifies a MIL object from group one of the user-defined object types allocated using MfuncAllocId() with M_USER_OBJECT_1.

You must specify a combination value from the following table:

To set the offset

(summarize)

Specifies a MIL object from group one of the user-defined object types allocated using MfuncAllocId() with M_USER_OBJECT_1.

(more details...)

M_USER_OBJECT_2 +

Specifies a MIL object from group two of the user-defined object types allocated using MfuncAllocId() with M_USER_OBJECT_2.

You must specify a combination value from the following table:

To set the offset

(summarize)

Specifies a MIL object from group two of the user-defined object types allocated using MfuncAllocId() with M_USER_OBJECT_2.

(more details...)

M_WAVELET_TRANSFORM_RESULT

Specifies a MIL wavelet transform result buffer allocated using MimAllocResult() with M_WAVELET_TRANSFORM_RESULT.

UserVarPtr

Data type info: Data type: address of a MIL_INT64

M_DMIL_PUBLISHED_NAME

Inquires the MIL object's MIL identifier from the MIL object's name.

(summarize)

Inquires the MIL object's MIL identifier from the MIL object's name.

(more details...)

ControlFlag

Specifies the following.

(summarize)

Specifies the following.

(more details...)

M_PTR_TO_MIL_INT(

MIL_CONST_TEXT_PTR String

)

Casts the address of the string identifying the MIL object, from a MIL_CONST_TEXT_PTR to a MIL_INT.

(summarize)

Casts the address of the string identifying the MIL object, from a MIL_CONST_TEXT_PTR to a MIL_INT.

(more details...)

Parameters

String

This parameter specifies the string whose address to cast.

MIL_TEXT("ObjectName") ¹

Specifies the name of the MIL object.

UserVarPtr

Data type info: Data type: address of a MIL_ID

¹ If you are passing the value in a variable, don't enclose it in MIL_TEXT().

Combination value for M_USER_OBJECT_1 (when InquireType=M_DMIL_PUBLISHED_LIST and ControlFlag=M_USER_OBJECT_1); M_USER_OBJECT_1 (when InquireType=M_DMIL_PUBLISHED_LIST_SIZE and ControlFlag=M_USER_OBJECT_1); M_USER_OBJECT_2 (when InquireType=M_DMIL_PUBLISHED_LIST and ControlFlag=M_USER_OBJECT_2); M_USER_OBJECT_2 (when InquireType=M_DMIL_PUBLISHED_LIST_SIZE and ControlFlag=M_USER_OBJECT_2).

You must add the following value to the above-mentioned values to set the offset.

The offset allows you to distinguish between the different object types of the same group (for example, M_USER_OBJECT_1 + 0x0001).

For distinguishing between the different object types
Combination value	Description
Value	Specifies the offset within the selected object type group. The value must have only one of its 16 least significant bits set. (summarize) Specifies the offset within the selected object type group. (more details...)

Return value

The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.

Compilation information

Header	Include mil.h.
Library	Use mil.lib.
DLL	Requires mil.dll.