MappInquireConnection

Synopsis

查詢 Distributed MIL publishing application 之中的 published MIL objects。

Syntax

MIL_INT MappInquireConnection(
    MIL_ID ContextAppId,    //in  
    MIL_INT64 InquireType,  //in  
    MIL_INT64 ControlFlag,  //in  
    MIL_INT64 ExtraFlag,    //in  
    void *UserVarPtr        //out  
)

Parameters

ContextAppId

指定使用的 application context identifier。

Value Description
M_DEFAULT 指定 current application context。
Application Context Identifier 指定 application context identifier。

一般來說，這用來指定一個遠端電腦上的 remote application 的 application context identifier。但是這也可以用來指定本機電腦中的 remote application，甚至 current application。


InquireType

指定要查詢的 Distributed MIL connection setting。

這個參數可使用的值，請看 Parameter associations。


ControlFlag

指定查詢操作的屬性。如果所選擇的查詢操作不需要這一項參數，請將此設為 M_DEFAULT。

這個參數可使用的值，請看 Parameter associations。


ExtraFlag

指定查詢操作的屬性。如果所選擇的查詢操作不需要這一項參數，請將此設為 M_DEFAULT。

這個參數可使用的值，請看 Parameter associations。


UserVarPtr

用來寫入查詢資訊的地址。

因為 MappInquireConnection() 也會回傳查詢的結果，所以你可以將這個參數設為M_NULL。

這個地址指向的資料，格式只能是以下三種之一：

  • array of type MIL_ID
  • MIL_ID
  • MIL_INT64

這個參數可使用的值，請看 Parameter associations。

Parameter associations

以下的表格會列出 InquireType、ControlFlag、ExtraFlag 所有可能的值，以及 UserVarPtr 可能的回傳值。

For inquiring about a DMIL monitoring configuration connection
InquireType Description
M_DMIL_PUBLISHED_LIST 取得 MIL objects identifiers 的列表。

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

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

M_3DMAP_GEOMETRY
Specifies a MIL 3D geometry object.

M_3DMAP_LASER_CONTEXT
Specifies a MIL 3D reconstruction context object that can be used for laser-line profiling.

M_3DMAP_LASER_DATA
Specifies a MIL 3D reconstruction result object that can store laser-line profiling results.

M_3DMAP_STAT_RESULT
Specifies a MIL 3D reconstruction result object which can be used to store statistics results.

M_APPLICATION
Specifies a MIL application object.

M_ARRAY
Specifies a MIL array object.

M_BEAD_CONTEXT
Specifies a bead context object.

M_BEAD_RESULT
Specifies a bead result object.

M_BLOB_FEATURE_LIST
Specifies a MIL blob feature list object.

M_BLOB_RESULT
Specifies a MIL blob result object.

M_CAL_CONTEXT
Specifies a MIL calibration context.

M_CAL_FIXTURING_OFFSET
Specifies a MIL fixturing offset object.

M_CODE_CONTEXT
Specifies a MIL code context object.

M_CODE_RESULT
Specifies a MIL code result object.

M_COL_MATCH_CONTEXT
Specifies a MIL color matching context object.

M_COL_MATCH_RESULT
Specifies a MIL color matching result object.

M_COUNT_LIST
Specifies a MIL MimCountDifference() result object.

M_DIGITIZER
Specifies a MIL digitizer object.

M_EDGE_CONTOUR
Specifies a MIL Edge Finder contour context object.

M_EDGE_CREST
Specifies a MIL Edge Finder crest context object.

M_EDGE_RESULT
Specifies a MIL Edge Finder result object.

M_EVENT_LIST
Specifies a MIL MimLocateEvent() result object.

M_EXTREME_LIST
Specifies a MIL MimFindExtreme() result object.

M_GRAPHIC_CONTEXT
Specifies a MIL graphics context object.

M_GRAPHIC_LIST
Specifies a MIL graphics result object.

M_HIST_LIST
Specifies a MIL MimHistogram() result object.

M_IM_CONTEXT
Specifies a MIL image processing context.

M_IMAGE
Specifies a MIL image object.

M_KERNEL
Specifies a MIL kernel object.

M_LUT
Specifies a MIL LUT object.

M_MEAS_CONTEXT
Specifies a MIL measurement context object.

M_MEAS_MARKER
Specifies a MIL measurement marker object.

M_MEAS_RESULT
Specifies a MIL measurement result object.

M_MET_CONTEXT
Specifies a MIL metrology context object.

M_MET_DERIVED_GEOMETRY_REGION
Specifies a MIL metrology derived geometry region object.

M_MET_RESULT
Specifies a MIL metrology result object.

M_MOD_GEOMETRIC
Specifies a MIL Model Finder context object that can be used to perform searches using a general geometric search algorithm.

M_MOD_GEOMETRIC_CONTROLLED
Specifies a MIL Model Finder context object that can be used to perform searches using a controlled geometric search algorithm.

M_MOD_RESULT
Specifies a MIL Model Finder result object.

M_OCR_FONT
Specifies a MIL OCR font context object.

M_OCR_RESULT
Specifies a MIL OCR result object.

M_PAT_MODEL
Specifies a MIL pattern matching model object.

M_PAT_RESULT
Specifies a MIL pattern matching result object.

M_PROJ_LIST
Specifies a MIL MimProject() result object.

M_REG_CONTEXT
Specifies a MIL registration context object.

M_REG_RESULT
Specifies a MIL registration result object.

M_SEQUENCE_CONTEXT
Specifies a sequence context object.

M_STAT_LIST
Specifies a MIL MimStat() result object.

M_STAT_MULTIPLE_RESULT
Specifies a MIL MimStatMultiple() result object.

M_STR_CONTEXT
Specifies a MIL String Reader context object.

M_STR_RESULT
Specifies a MIL String Reader result object.

M_STRUCT_ELEMENT
Specifies a MIL structural element object.

M_SYSTEM
Specifies a MIL system object.

M_USER_OBJECT_1
Specifies the first user-defined object.

M_USER_OBJECT_2
Specifies the second user-defined object.
</blockquote>
ExtraFlag
Specifies the size of the array.

UserVarPtr
Data type: array of type MIL_ID
Array size: Specified with ExtraFlag.
M_DMIL_PUBLISHED_LIST_SIZE Inquires the current number of MIL objects published on a host.

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

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

M_3DMAP_GEOMETRY
Specifies a MIL 3D geometry object.

M_3DMAP_LASER_CONTEXT
Specifies a MIL 3D reconstruction context object that can be used for laser-line profiling.

M_3DMAP_LASER_DATA
Specifies a MIL 3D reconstruction result object that can store laser-line profiling results.

M_3DMAP_STAT_RESULT
Specifies a MIL 3D reconstruction result object which can be used to store statistics results.

M_APPLICATION
Specifies a MIL application object.

M_ARRAY
Specifies a MIL array object.

M_BEAD_CONTEXT
Specifies a bead context object.

M_BEAD_RESULT
Specifies a bead result object.

M_BLOB_FEATURE_LIST
Specifies a MIL blob feature list object.

M_BLOB_RESULT
Specifies a MIL blob result object.

M_CAL_CONTEXT
Specifies a MIL calibration context.

M_CAL_FIXTURING_OFFSET
Specifies a MIL fixturing offset object.

M_CODE_CONTEXT
Specifies a MIL code context object.

M_CODE_RESULT
Specifies a MIL code result object.

M_COL_MATCH_CONTEXT
Specifies a MIL color matching context object.

M_COL_MATCH_RESULT
Specifies a MIL color matching result object.

M_COUNT_LIST
Specifies a MIL MimCountDifference() result object.

M_DIGITIZER
Specifies a MIL digitizer object.

M_EDGE_CONTOUR
Specifies a MIL Edge Finder contour context object.

M_EDGE_CREST
Specifies a MIL Edge Finder crest context object.

M_EDGE_RESULT
Specifies a MIL Edge Finder result object.

M_EVENT_LIST
Specifies a MIL MimLocateEvent() result object.

M_EXTREME_LIST
Specifies a MIL MimFindExtreme() result object.

M_GRAPHIC_CONTEXT
Specifies a MIL graphics context object.

M_GRAPHIC_LIST
Specifies a MIL graphics result object.

M_HIST_LIST
Specifies a MIL MimHistogram() result object.

M_IM_CONTEXT
Specifies a MIL image processing context.

M_IMAGE
Specifies a MIL image object.

M_KERNEL
Specifies a MIL kernel object.

M_LUT
Specifies a MIL LUT object.

M_MEAS_CONTEXT
Specifies a MIL measurement context object.

M_MEAS_MARKER
Specifies a MIL measurement marker object.

M_MEAS_RESULT
Specifies a MIL measurement result object.

M_MET_CONTEXT
Specifies a MIL metrology context object.

M_MET_DERIVED_GEOMETRY_REGION
Specifies a MIL metrology derived geometry region object.

M_MET_RESULT
Specifies a MIL metrology result object.

M_MOD_GEOMETRIC
Specifies a MIL Model Finder context object that can be used to perform searches using a general geometric search algorithm.

M_MOD_GEOMETRIC_CONTROLLED
Specifies a MIL Model Finder context object that can be used to perform searches using a controlled geometric search algorithm.

M_MOD_RESULT
Specifies a MIL Model Finder result object.

M_OCR_FONT
Specifies a MIL OCR font context object.

M_OCR_RESULT
Specifies a MIL OCR result object.

M_PAT_MODEL
Specifies a MIL pattern matching model object.

M_PAT_RESULT
Specifies a MIL pattern matching result object.

M_PROJ_LIST
Specifies a MIL MimProject() result object.

M_REG_CONTEXT
Specifies a MIL registration context object.

M_REG_RESULT
Specifies a MIL registration result object.

M_SEQUENCE_CONTEXT
Specifies a sequence context object.

M_STAT_LIST
Specifies a MIL MimStat() result object.

M_STAT_MULTIPLE_RESULT
Specifies a MIL MimStatMultiple() result object.

M_STR_CONTEXT
Specifies a MIL String Reader context object.

M_STR_RESULT
Specifies a MIL String Reader result object.

M_STRUCT_ELEMENT
Specifies a MIL structural element object.

M_SYSTEM
Specifies a MIL system object.

M_USER_OBJECT_1
Specifies the first user-defined object.

M_USER_OBJECT_2
Specifies the second user-defined object.
</blockquote>
UserVarPtr
Data type info
Data type: MIL_INT64
M_DMIL_PUBLISHED_NAME Inquires the MIL object's MIL identifier from the MIL object's name.

ControlFlag
Specifies the following.

M_PTR_TO_MIL_INT( MIL_CONST_TEXT_PTR * String )
Casts the MIL object name from a MIL_CONST_TEXT_PTR to a MIL_INT.
</blockquote>
UserVarPtr
Data type info
Data type: MIL_ID

Return value

回傳值是查詢的資料，格式是 MIL_INT，如果查詢的資料不是單一的值，或者不是 MIL_INT ，函式便回傳 M_NULL。

Compilation information

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

results matching ""

    No results matching ""