Synopsis
Inquire about the application.
Format
long MappInquire(ParamToInquire, UserVarPtr)
| long InquireType; | Type of information to inquire |
| void *UserVarPtr; | Storage location for inquired information |
Description
This function inquires about the specified application control, processing mode, or memory setting.
The InquireType parameter specifies the type of information to inquire about. This parameter can be set to one of the following values. See MappControl for more information about these values. In multi-thread environments, you can inquire the status of a control from any thread; however, to inquire the status of a thread-specific parameter, add M_THREAD_CURRENT to the InquireType parameter (M_ERROR+M_THREAD_CURRENT).
| InquireType | Description |
| M_ERROR | Error printing mode (M_PRINT_ENABLE or M_PRINT_DISABLE). |
| M_TRACE | Trace printing mode (M_PRINT_ENABLE or M_PRINT_DISABLE). |
| M_PARAMETER | Parameter checking mode (M_CHECK_ENABLE or M_CHECK_DISABLE). |
| M_PROCESSING | Processing compensation mode (M_COMPENSATION_ENABLE or M_COMPENSATION_DISABLE). |
| M_MEMORY | Memory compensation mode (M_COMPENSATION_ENABLE or M_COMPENSATION_DISABLE). |
| M_VERSION | Version of MIL library. |
| M_OBJECT_TYPE+(MILId) | Type of the specified MIL object. (M_APPLICATION, M_SYSTEM, M_LUT, M_DISPLAY, M_DIGITIZER, M_IMAGE, M_KERNEL, M_STRUCT_ELEMENT, M_HIST_LIST, M_EXTREME_LIST, M_PROJ_LIST, M_EVENT_LIST, M_COUNT_LIST, M_BLOB_OBJECT, M_PAT_OBJECT, M_GRAPHIC_CONTEXT, M_OCR_OBJECT, M_USER_OBJECT_1, or M_USER_OBJECT_2) |
The UserVarPtr parameter specifies the address of the variable in which the requested information is to be written. Since the MappInquire function also returns the requested information, you can set this parameter to M_NULL. The variable should be a pointer to a long, unless you are using M_VERSION, in which case it should be a pointer to a double.
Returned value
The returned value is the requested system information cast to long.
See also