MappInquire

Filters
See also

User Guide:

MIL and MIL-Lite licenses Matrox Profiler and trace logs Multiple systems Protecting your own MIL software application using a Matrox hardware fingerprint

Reference:

MappAlloc MappControl MappHookFunction MsysAlloc MsysInquire

Availability

Available in MIL-Lite

Available in MIL

Available on Windows with restrictions

Available on Linux with restrictions

Available on Matrox 4Sight GP/GPm with restrictions

Available on Matrox 4Sight-X with restrictions

Available on Matrox Supersight with restrictions

Available on Non-Matrox computer with restrictions

Function map

Examples

MappHookFunction

MappInquireConnection

Function Map

Table:

For specifying the application context

- InquireType

- UserVarPtr

Parameter Associations

Table:	For inquiring about general types of application settings
+ combination:	For M_ERROR, M_MEMORY, M_PARAMETER, M_PROCESSING, and M_TRACE
Table:	For inquiring system fingerprints
+ combination:	For distinguishing between different iterations of the same MIL system

Return value

Compilation information

Synopsis

Inquire about an application setting.

Syntax

MIL_INT MappInquire(

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

)

Description

This function inquires about the specified application setting.

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.

InquireType

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

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_TEXT_CHAR
MIL_DOUBLE
MIL_ID
MIL_INT

Specifies the address in which to write the requested information. Since the MappInquire() 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 tables below list possible values for the InquireType parameter and possible values returned to the UserVarPtr parameter.

For inquiring about general types of application settings
For inquiring system fingerprints

The following inquire types allow you to inquire about general types of application settings.

For inquiring about general types of application settings
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_CURRENT_APPLICATION		Inquires the identifier of the current MIL application, if any. (summarize) Inquires the identifier of the current MIL application, if any. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_ID Data type info: Data type: address of a MIL_ID
	0	Specifies that no application is allocated. Note that no error is generated. (summarize) Specifies that no application is allocated. (more details...)
	MIL application identifier	Specifies the identifier of the current MIL application.
M_DIRECTX_VERSION		[This is only applicable to Windows] Inquires the version of DirectX that MIL can use for display purposes under Windows. This determines the hardware acceleration display mode. SET (summarize) [This is only applicable to Windows] Inquires the version of DirectX that MIL can use for display purposes under Windows. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that DirectX cannot be used. INFO
	9 <= Value <= 11	Specifies that either DirectX version 9.0, 10.0, or 11.0 can be used, respectively. INFO
M_DMIL_CONNECTION		Inquires the Distributed MIL monitoring configuration permission level. SET (summarize) Inquires the Distributed MIL monitoring configuration permission level. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	M_DISABLE	Specifies that Distributed MIL monitoring configuration is disabled in the current application. INFO
	M_DMIL_CONTROL	Specifies that MIL objects in the current application can be accessed with either read only or read/write permission, depending on how that MIL object was specified with MobjControl().
	M_DMIL_MONITOR	Specifies that MIL objects in the current application can be accessed only with read only permission, regardless of how that MIL object was specified with MobjControl().
M_DMIL_CONNECTION_PORT		Inquires the listening port of a publishing application in the Distributed MIL monitoring configuration. SET (summarize) Inquires the listening port of a publishing application in the Distributed MIL monitoring configuration. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	Listening port	Specifies the listening port (an integer between 0 and 65535) that the current application will use to listen for connections from a monitoring application.
M_ERROR +		Inquires the error printing mode. SET (summarize) Inquires the error printing mode. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	M_PRINT_DISABLE	Specifies not to print error messages. INFO
	M_PRINT_ENABLE	Specifies to print error messages.
	M_THROW_EXCEPTION	Specifies that when an error occurs, a .NET exception will be thrown instead of a message box being displayed. M_THROW_EXCEPTION is only valid when working in a .NET environment. (summarize) Specifies that when an error occurs, a .NET exception will be thrown instead of a message box being displayed. (more details...)
M_ERROR_HOOKS		Inquires whether an error event type (specified using MappHookFunction() set to M_ERROR_CURRENT, M_ERROR_GLOBAL, or M_ERROR_FATAL) will trigger the user defined function specified in MappHookFunction(). SET (summarize) Inquires whether an error event type (specified using MappHookFunction() set to M_ERROR_CURRENT, M_ERROR_GLOBAL, or M_ERROR_FATAL) will trigger the user defined function specified in MappHookFunction(). SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	M_DISABLE	Specifies to not trigger the user-defined function when an error event type occurs, as specified in MappHookFunction(). INFO
	M_ENABLE	Specifies to trigger the user-defined function when an error event type occurs, as specified in MappHookFunction().
M_INSTALLED_SYSTEM_COUNT		Inquires the number of different system types installed during MIL installation. (summarize) Inquires the number of different system types installed during MIL installation. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	Value	Specifies the number of different system types installed.
M_INSTALLED_SYSTEM_DESCRIPTOR + n		Inquires the descriptor of system type n, where n is a number between 0 and the value returned by M_INSTALLED_SYSTEM_COUNT. The descriptor can be passed to MsysAlloc() to allocate the system. SET (summarize) Inquires the descriptor of system type n, where n is a number between 0 and the value returned by M_INSTALLED_SYSTEM_COUNT. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: array of type MIL_TEXT_CHAR (more details...) Data type: array of type MIL_TEXT_CHAR Required array size: MappInquire() with M_INSTALLED_SYSTEM_DESCRIPTOR_SIZE Data type info: Data type: array of type MIL_TEXT_CHAR (more details...) Data type: array of type MIL_TEXT_CHAR Required array size: MappInquire() with M_INSTALLED_SYSTEM_DESCRIPTOR_SIZE
	M_SYSTEM_1394	Specifies a MIL IEEE 1394b IIDC system.
	M_SYSTEM_CLARITY_UHD	Specifies a MIL Clarity UHD system.
	M_SYSTEM_CRONOSPLUS	Specifies a MIL CronosPlus system.
	M_SYSTEM_DEFAULT	Specifies the default system. INFO
	M_SYSTEM_GIGE_VISION	Specifies a MIL GigE Vision system. INFO
	M_SYSTEM_GPU	Specifies a MIL GPU system.
	M_SYSTEM_HOST	Specifies a Host system. INFO
	M_SYSTEM_IRIS_GT	Specifies a MIL Iris GT system.
	M_SYSTEM_IRIS_GTR	Specifies a MIL Iris GTR system.
	M_SYSTEM_MORPHIS	Specifies a MIL Morphis system.
	M_SYSTEM_MORPHISQXT	Specifies a MIL Morphis QxT system.
	M_SYSTEM_ORION_HD	Specifies a MIL Orion HD system.
	M_SYSTEM_RADIENT	Specifies a MIL Radient system.
	M_SYSTEM_RADIENTCLHS	Specifies a MIL Radient eV-CLHS system.
	M_SYSTEM_RADIENTCXP	Specifies a MIL Radient eV-CXP system.
	M_SYSTEM_RADIENTEVCL	Specifies a MIL Radient eV-CL system.
	M_SYSTEM_RADIENTPRO	Specifies a MIL Radient Pro Camera-Link system.
	M_SYSTEM_SOLIOS	Specifies a MIL Solios system.
	M_SYSTEM_USB3_VISION	Specifies a MIL USB3 Vision system. INFO
	M_SYSTEM_VIO	Specifies a MIL Vio system.
	MIL_TEXT("dmilpcie://[Passkey:]RemoteComputerName[:Port]/MILSystemType") ¹	Specifies a DMIL remote system on a remote Matrox Supersight SHB that will communicate with the local SHB, using the PCIe protocol. INFO
	MIL_TEXT("dmilshm://[Passkey:]localhost[:Port]/MILSystemType") ¹	Specifies a DMIL remote system for a separate process on the local computer, using the DMIL SHM protocol. INFO
	MIL_TEXT("dmiltcp://[Passkey:]RemoteComputerName[:Port]/MILSystemType") ¹	Specifies a DMIL remote system on a remote or local computer, using the TCP/IP protocol. INFO
M_INSTALLED_SYSTEM_DESCRIPTOR_SIZE		Inquires the size of the descriptor string of a system. (summarize) Inquires the size of the descriptor string of a system. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	Value	Specifies the size of the descriptor string.
M_INSTALLED_SYSTEM_PRINT_NAME + n		Inquires the printable name of system type n (for example, Matrox Radient), where n is a number between 0 and the value returned by M_INSTALLED_SYSTEM_COUNT. (summarize) Inquires the printable name of system type n (for example, Matrox Radient), where n is a number between 0 and the value returned by M_INSTALLED_SYSTEM_COUNT. (more details...)
	UserVarPtr extra info	Data type info: Data type: array of type MIL_TEXT_CHAR (more details...) Data type: array of type MIL_TEXT_CHAR Required array size: MappInquire() with M_INSTALLED_SYSTEM_PRINT_NAME_SIZE Data type info: Data type: array of type MIL_TEXT_CHAR (more details...) Data type: array of type MIL_TEXT_CHAR Required array size: MappInquire() with M_INSTALLED_SYSTEM_PRINT_NAME_SIZE
	String	Specifies the printable name of system type n.
M_INSTALLED_SYSTEM_PRINT_NAME_SIZE		Inquires the size of the printable name of a system. (summarize) Inquires the size of the printable name of a system. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	Value	Specifies the size of the system's printable name.
M_INSTALLED_SYSTEM_TYPE + n		Inquires the type of system type n, where n is a number between 0 and the value returned by M_INSTALLED_SYSTEM_COUNT. SET (summarize) Inquires the type of system type n, where n is a number between 0 and the value returned by M_INSTALLED_SYSTEM_COUNT. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	M_SYSTEM_1394_TYPE	Specifies a MIL IEEE 1394 IIDC system.
	M_SYSTEM_CLARITY_UHD_TYPE	Specifies a MIL Clarity UHD system.
	M_SYSTEM_CRONOSPLUS_TYPE	Specifies a MIL CronosPlus system.
	M_SYSTEM_GIGE_VISION_TYPE	Specifies a MIL GigE Vision system.
	M_SYSTEM_GPU_TYPE	Specifies a MIL GPU system.
	M_SYSTEM_HOST_TYPE	Specifies the Host.
	M_SYSTEM_IRIS_GT_TYPE	Specifies a MIL Iris GT system.
	M_SYSTEM_IRIS_GTR_TYPE	Specifies a MIL Iris GTR system.
	M_SYSTEM_MORPHIS_TYPE	Specifies a MIL Morphis system.
	M_SYSTEM_MORPHISQXT_TYPE	Specifies a MIL Morphis QxT system.
	M_SYSTEM_ORION_HD_TYPE	Specifies a MIL Orion HD system.
	M_SYSTEM_RADIENT_TYPE	Specifies a MIL Radient system.
	M_SYSTEM_RADIENTCLHS_TYPE	Specifies a MIL Radient eV-CLHS system.
	M_SYSTEM_RADIENTCXP_TYPE	Specifies a MIL Radient eV-CXP system.
	M_SYSTEM_RADIENTEVCL_TYPE	Specifies a MIL Radient eV-CL system.
	M_SYSTEM_RADIENTPRO_TYPE	Specifies a MIL Radient Pro system.
	M_SYSTEM_SOLIOS_TYPE	Specifies a MIL Solios system.
	M_SYSTEM_USB3_VISION_TYPE	Specifies a MIL USB3 Vision system.
	M_SYSTEM_VIO_TYPE	Specifies a MIL Vio system.
M_LICENSE_MODULES		Inquires the modules for which there is a valid license. The value returned will be a bitwise combination of the following. (summarize) Inquires the modules for which there is a valid license. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	M_LICENSE_3DCA	Specifies a 3D camera calibration module license.
	M_LICENSE_3DMAP	Specifies a 3D Reconstruction module license.
	M_LICENSE_BEAD	Specifies a Bead module license.
	M_LICENSE_BLOB	Specifies a Blob analysis module license.
	M_LICENSE_CAL	Specifies a camera calibration module license.
	M_LICENSE_CODE	Specifies a Code read/write module license.
	M_LICENSE_COL	Specifies a Color Analysis module license.
	M_LICENSE_DEBUG	Specifies a development license.
	M_LICENSE_DMIL	Specifies a Distributed MIL license.
	M_LICENSE_DMR	Specifies a SureDotOCR module license.
	M_LICENSE_EDGE	Specifies an Edge Finder module license.
	M_LICENSE_GPU	Specifies a Matrox GPU driver license.
	M_LICENSE_IM	Specifies an Image Processing module license.
	M_LICENSE_INTERFACE	Specifies a Matrox IEEE1394 IIDC driver and Matrox GigE Vision driver license.
	M_LICENSE_JPEG2000	Specifies a JPEG2000 compression license.
	M_LICENSE_JPEGSTD	Specifies a JPEG compression license.
	M_LICENSE_LITE	Specifies a MIL-Lite module license.
	M_LICENSE_MEAS	Specifies a Measurement module license.
	M_LICENSE_MET	Specifies a Metrology module license.
	M_LICENSE_MOD	Specifies a Geometric Model Finder module license.
	M_LICENSE_OCR	Specifies an OCR module license.
	M_LICENSE_PAT	Specifies a Pattern Matching module license.
	M_LICENSE_REG	Specifies a Registration module license.
	M_LICENSE_STR	Specifies a String Reader module license.
M_MAX_SYSTEMS_PER_TYPE		Inquires the maximum amount of systems of the selected type. (summarize) Inquires the maximum amount of systems of the selected type. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0 <= Value < 16	Specifies the number of systems to be used.
M_MEMORY +		Inquires the memory compensation mode. SET (summarize) Inquires the memory compensation mode. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	M_COMPENSATION_DISABLE	Specifies that on-board memory compensation is disabled. INFO
	M_COMPENSATION_ENABLE	Specifies that on-board memory compensation is enabled.
M_NON_PAGED_MEMORY_FREE		Inquires the amount of free non-paged memory reserved for MIL (at installation time or using the MILConfig utility). (summarize) Inquires the amount of free non-paged memory reserved for MIL (at installation time or using the MILConfig utility). (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	Value	Specifies the amount of free non-paged memory, in bytes.
M_NON_PAGED_MEMORY_SIZE		Inquires the amount of the non-paged memory (DMA) reserved for MIL. (summarize) Inquires the amount of the non-paged memory (DMA) reserved for MIL. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	Value	Specifies the amount of the non-paged memory (DMA) reserved for MIL, in bytes.
M_NON_PAGED_MEMORY_USED		Inquires the amount of non-paged memory being used. (summarize) Inquires the amount of non-paged memory being used. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	Value	Specifies the amount of non-paged memory being used, in bytes.
M_PARAMETER +		Inquires the parameter checking mode. SET (summarize) Inquires the parameter checking mode. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	M_CHECK_DISABLE	Specifies that checking of parameters is disabled. INFO
	M_CHECK_ENABLE	Specifies that checking of parameters is enabled.
M_PLATFORM_BITNESS		Inquires the bitness for which the MIL application has been compiled. (summarize) Inquires the bitness for which the MIL application has been compiled. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	32	Specifies that the specified application is 32-bit.
	64	Specifies that the specified application is 64-bit.
M_PLATFORM_OS_TYPE		Inquires the operating system under which the specified MIL application is running. (summarize) Inquires the operating system under which the specified MIL application is running. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	M_OS_LINUX	Specifies that the specified application is running under a Linux operating system.
	M_OS_RTX	Specifies that the specified application is running under a Interval Zero RTX operating system.
	M_OS_WINDOWS	Specifies that the specified application is running under a Microsoft Windows operating system.
	M_OS_WINDOWS_CE	Specifies that the specified application is running under a Microsoft Windows Embedded Compact operating system.
M_PROCESSING +		Inquires the processing compensation mode. SET (summarize) Inquires the processing compensation mode. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	M_COMPENSATION_DISABLE	Specifies that on-board processing compensation is disabled. INFO
	M_COMPENSATION_ENABLE	Specifies that on-board processing compensation is enabled. INFO
M_TRACE +		Inquires the trace setting, which is used to start or stop generating a trace log. Note that this inquire type can return M_DEFAULT, a trace setting which can signify either to start or to stop generating a trace log. Use M_TRACE_ACTIVE to determine if a trace log is currently being generated. SET (summarize) Inquires the trace setting, which is used to start or stop generating a trace log. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	M_DEFAULT	Specifies the default trace setting, which either enables or disables generating a trace log, based on whether Matrox Profiler (or Matrox Interactive log) was used to start generating the log. INFO
	M_LOG_DISABLE	Specifies the log disable setting, which stops generating the trace log.
	M_LOG_ENABLE	Specifies the log enable setting, which starts generating the trace log.
M_TRACE_ACTIVE		Inquires whether a trace log is currently being generated in the current thread. Note that adding the combination constant M_THREAD_CURRENT to this inquire will result in an error. (summarize) Inquires whether a trace log is currently being generated in the current thread. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	M_NO	Specifies that a trace log is not currently being generated in the current thread.
	M_YES	Specifies that a trace log is currently being generated in the current thread.
M_VERSION		Inquires the version of the MIL library. (summarize) Inquires the version of the MIL library. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the version of the MIL library.
M_XORG_ACCELERATION		[This is only applicable to Linux] Inquires whether MIL can use X11 (Xorg) acceleration for display under Linux. This determines the hardware acceleration display mode. SET (summarize) [This is only applicable to Linux] Inquires whether MIL can use X11 (Xorg) acceleration for display under Linux. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that X11 acceleration cannot be used. INFO
	1	Specifies that X11 acceleration can be used. INFO

¹ If the value was passed in a variable, it won't be returned enclosed in MIL_TEXT().

Combination value for M_ERROR; M_MEMORY; M_PARAMETER; M_PROCESSING; M_TRACE.

You can add the following value to the above-mentioned values to specify that the inquire should be limited to the current thread.

In multi-thread environments, by default, you can inquire about an application setting from any thread.

For M_ERROR, M_MEMORY, M_PARAMETER, M_PROCESSING, and M_TRACE
Combination value	Description
M_THREAD_CURRENT	Specifies that data to be returned should relate to the current thread.

When inquired and present, the requested system fingerprint is returned. If that specific fingerprint is not present, 0 is returned. For more information about system fingerprints, see the Protecting your own MIL software application using a Matrox hardware fingerprint section of Chapter 34: Distribution and licensing.

For inquiring system fingerprints
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_4SIGHTGP_FINGERPRINT +		[This is only applicable to Matrox 4Sight GP/GPm platform] Inquires the hardware fingerprint of a Matrox 4Sight-GP/GPm. (summarize) [This is only applicable to Matrox 4Sight GP/GPm platform] Inquires the hardware fingerprint of a Matrox 4Sight-GP/GPm. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the current computer is not a Matrox 4Sight-GP/GPm.
	Value	Specifies the hardware fingerprint.
M_4SIGHTX_FINGERPRINT +		[This is only applicable to Matrox 4Sight-X platform] Inquires the hardware fingerprint of a Matrox 4Sight-X. (summarize) [This is only applicable to Matrox 4Sight-X platform] Inquires the hardware fingerprint of a Matrox 4Sight-X. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the current computer is not a Matrox 4Sight-X.
	Value	Specifies the hardware fingerprint.
M_ANY_FINGERPRINT +		Inquires any hardware fingerprint. (summarize) Inquires any hardware fingerprint. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that no hardware that has been correctly installed has a fingerprint.
	Value	Specifies the hardware fingerprint.
M_CONCORD_1394_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox Concord 1394 board. (summarize) Inquires the hardware fingerprint of a Matrox Concord 1394 board. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the board is not present in the computer, or that the board is incorrectly installed.
	Value	Specifies the hardware fingerprint.
M_CONCORD_GIGE_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox Concord GigE Vision board. (summarize) Inquires the hardware fingerprint of a Matrox Concord GigE Vision board. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the board is not present in the computer, or that the board is incorrectly installed.
	Value	Specifies the hardware fingerprint.
M_CRONOSPLUS_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox CronosPlus board. (summarize) Inquires the hardware fingerprint of a Matrox CronosPlus board. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the board is not present in the computer, or that the board is incorrectly installed.
	Value	Specifies the hardware fingerprint.
M_ID_KEY_FINGERPRINT +		Inquires the hardware fingerprint of a hardware identification key. The hardware identification key is the device, which when connected to your USB or parallel port, you can use as a hardware fingerprint to generate a software license. (summarize) Inquires the hardware fingerprint of a hardware identification key. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the hardware identification key is not connected to the computer, or that it is not correctly installed.
	Value	Specifies the hardware fingerprint.
M_IRISGT_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox Iris GT. (summarize) Inquires the hardware fingerprint of a Matrox Iris GT. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the current computer is not a Matrox Iris GT.
	Value	Specifies the hardware fingerprint.
M_IRISGTR_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox Iris GTR. (summarize) Inquires the hardware fingerprint of a Matrox Iris GTR. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the current computer is not a Matrox Iris GTR.
	Value	Specifies the hardware fingerprint.
M_MSERIES_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox M-Series board. (summarize) Inquires the hardware fingerprint of a Matrox M-Series board. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the board is not present in the computer, or that the board is incorrectly installed.
	Value	Specifies the hardware fingerprint.
M_ORIONHD_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox Orion HD board. (summarize) Inquires the hardware fingerprint of a Matrox Orion HD board. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the board is not present in the computer, or that the board is incorrectly installed.
	Value	Specifies the hardware fingerprint.
M_RADIENT_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox Radient board. (summarize) Inquires the hardware fingerprint of a Matrox Radient board. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the board is not present in the computer, or that the board is incorrectly installed.
	Value	Specifies the hardware fingerprint.
M_RADIENTCLHS_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox Radient CLHS board. (summarize) Inquires the hardware fingerprint of a Matrox Radient CLHS board. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the board is not present in the computer, or that the board is incorrectly installed.
	Value	Specifies the hardware fingerprint.
M_RADIENTCXP_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox Radient eV-CXP board. (summarize) Inquires the hardware fingerprint of a Matrox Radient eV-CXP board. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the board is not present in the computer, or that the board is incorrectly installed.
	Value	Specifies the hardware fingerprint.
M_SOLIOS_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox Solios board. (summarize) Inquires the hardware fingerprint of a Matrox Solios board. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the board is not present in the computer, or that the board is incorrectly installed.
	Value	Specifies the hardware fingerprint.
M_SUPERSIGHT_FINGERPRINT +		[This is only applicable to Matrox Supersight platform] Inquires the hardware fingerprint of a Matrox Supersight. (summarize) [This is only applicable to Matrox Supersight platform] Inquires the hardware fingerprint of a Matrox Supersight. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the current computer is not a Matrox Supersight.
	Value	Specifies the hardware fingerprint.
M_VIO_FINGERPRINT +		Inquires the hardware fingerprint of a Matrox Vio board. (summarize) Inquires the hardware fingerprint of a Matrox Vio board. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT
	0	Specifies that the board is not present in the computer, or that the board is incorrectly installed.
	Value	Specifies the hardware fingerprint.

Combination value for M_4SIGHTGP_FINGERPRINT; M_4SIGHTX_FINGERPRINT; M_ANY_FINGERPRINT; M_CONCORD_1394_FINGERPRINT; M_CONCORD_GIGE_FINGERPRINT; M_CRONOSPLUS_FINGERPRINT; M_ID_KEY_FINGERPRINT; M_IRISGT_FINGERPRINT; M_IRISGTR_FINGERPRINT; M_MSERIES_FINGERPRINT; M_ORIONHD_FINGERPRINT; M_RADIENT_FINGERPRINT; M_RADIENTCLHS_FINGERPRINT; M_RADIENTCXP_FINGERPRINT; M_SOLIOS_FINGERPRINT; M_SUPERSIGHT_FINGERPRINT; M_VIO_FINGERPRINT.

You can add the following value to the above-mentioned values to determine how many iterations of the same MIL system there are.

When multiple fingerprints of the same type are present, all similar fingerprints can be inquired using the following.

For distinguishing between different iterations of the same MIL system
Combination value	Description
0 <= Value < M_MAX_SYSTEMS_PER_TYPE	Specifies that multiple fingerprints of the same type can be inquired about.

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.