MsysIoControl

See also

User Guide:

Using I/O command lists

Reference:

MsysIoAlloc MsysIoInquire

Availability

Available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Not supported on:

Not supported on Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)* (c)

Not supported on Matrox Morphis (g)

Not supported on Matrox Morphis QxT (h)

Not supported on Matrox Orion HD (i)

Not supported on Matrox Radient eCL (j)

Not supported on Matrox Radient eV-CXP (MIL 10 or Update 29)* (k)

Not supported on Matrox Solios eA/XA (l)

Not supported on Matrox Solios ecl/xcl/ev-cl (m)

Not supported on Matrox USB3 Vision driver (Update 19) (o)

Not supported on Matrox RadientPro-CL (Update 7) (p)

Not supported on Matrox Radient eV-CL (Update 27 or 74) (r)

Not supported on Matrox Clarity UHD (Update 36 or 76) (u)

Not supported on Matrox GenTL driver (Update 34) (v)

Not supported on Matrox Rapixo CXP (Update 75 or Update 84) (y)

Not supported on Matrox Rapixo CL Pro (Update 96) (aa)

Partially supported on:

Partially supported on Host system (a)

Partially supported on Matrox Iris GTR (Update 28 or Update 68) (t)

Partially supported on Matrox Indio (Update 53 or Update 68) (w)

Partially supported on Matrox Concord PoE with ToE (Update 82) (z)

* Refer to the MIL system-specific information
in the MIL Reference for the minimum update required.

For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note

Not available on Matrox 4Sight-X

Not available on Matrox Supersight

Available on Non-Matrox computer with restrictions

Available on Matrox 4Sight GP/GPm

Function map

Examples

msysio.cpp

MsysIoCommandRegister

Function Map

Parameter Associations

Table:	For controlling I/O command list settings
Table:	For controlling an I/O command list reference latch
+ combination:	For specifying the reference latch to affect

Compilation information

Synopsis

Control an I/O command list setting.

Syntax

void MsysIoControl(

MIL_ID IoCmdListSysId,	//in
MIL_INT64 ControlType,	//in
MIL_DOUBLE ControlValue	//in

)

Description

This function allows you to control an I/O command list setting.

To inquire the current value of a particular I/O command list setting, use MsysIoInquire().

[Matrox 4Sight GP/GPm]

On a Matrox 4Sight GPm computer, this function is only available if a MIL Host system was previously allocated. It is not available on a Matrox 4Sight GP.

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 which MIL system’s documentation you should use in its place and any possible differences.

Parameters

This function is not supported on the selected boards.

This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.

Parameters

IoCmdListSysId

Specifies the identifier of the I/O command list.

ControlType

Specifies the type of I/O command list setting to control.

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

ControlValue

Specifies the new value to assign to the I/O command list setting specified by the ControlType parameter.

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

Parameter associations

The tables below list possible values for the ControlType and ControlValue parameters.

For controlling I/O command list settings
For controlling an I/O command list reference latch

The following control type allows you to control an I/O command list setting.

For controlling I/O command list settings
ControlType		Description		MIL system-specific tooltip (‡)
	ControlValue	Description
M_IO_COMMAND_CANCEL		Clears the specified I/O command list of any command that affects the specified I/O command register bits. [Matrox 4Sight GP/GPm] On a Matrox 4Sight GPm platform, this value is only available if MIL 10 update 51 (or later) is installed. It is not available on a Matrox 4Sight GP. (summarize) Clears the specified I/O command list of any command that affects the specified I/O command register bits. (more details...)							‡	a	t U28	w U53	z
	M_IO_COMMAND_BIT_MASK( MIL_INT BitMaskValue )	Specifies I/O command register bits using a bit-encoded value, in which each bit represents one I/O command register bit. (summarize) Specifies I/O command register bits using a bit-encoded value, in which each bit represents one I/O command register bit. (more details...)		‡	a	t U28	w U53	z
			Parameters
			BitMaskValue Specifies the bit encoded value.	‡	a	t U28	w U53	z
	M_IO_COMMAND_BITn	Specifies the I/O command register bit n, where n is a number from 0 to 7. (summarize) Specifies the I/O command register bit n, where n is a number from 0 to 7. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			For the Matrox Iris GTR, n can be a value from 0 to 3.	‡		t U28
M_IO_COMMAND_COUNTER_ACTIVATION		Sets which edge of the source signal to use to increment the I/O command list's internal counter. This setting should be changed only when the I/O command list is allocated using MsysIoAlloc() with M_AUX_IOn. INQ (summarize) Sets which edge of the source signal to use to increment the I/O command list's internal counter. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm computer, this function is only available if a MIL Host system was previously allocated. It is not available on a Matrox 4Sight GP.	‡	a
	M_DEFAULT	Same as M_EDGE_RISING.		‡	a	t U28	w U53	z
	M_ANY_EDGE	Specifies to use both a low-to-high and a high-to-low signal transition to increment the I/O command list's internal counter.		‡	a	t U28	w U53	z
	M_EDGE_FALLING	Specifies to use a high-to-low signal transition to increment the I/O command list's internal counter.		‡	a	t U28	w U53	z
	M_EDGE_RISING	Specifies to use a low-to-high signal transition to increment the I/O command list's internal counter.		‡	a	t U28	w U53	z

The following control types allow you to control settings for one of the I/O command list's reference latches. Reference latches are used to store a time or counter value when the required signal transition occurs on a specified input signal. You can then inquire the time or counter value saved in the latch using MsysIoInquire() with M_REFERENCE_LATCH_VALUE.

For controlling an I/O command list reference latch
ControlType		Description		MIL system-specific tooltip (‡)
	ControlValue	Description
M_REFERENCE_LATCH_ACTIVATION +		Sets the signal transition upon which to store the time or counter value to the specified reference latch. INQ You must specify a combination value from the following table: To specify which reference latch to affect (summarize) Sets the signal transition upon which to store the time or counter value to the specified reference latch. INQ (more details...)							‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm computer, this function is only available if a MIL Host system was previously allocated. It is not available on a Matrox 4Sight GP.	‡	a
	M_DEFAULT	Same as M_EDGE_RISING.		‡	a	t U28	w U53	z
	M_ANY_EDGE	Specifies to store the time or counter value to the latch upon both a low-to-high and a high-to-low signal transition.		‡	a	t U28	w U53	z
	M_EDGE_FALLING	Specifies to store the time or counter value to the latch upon a high-to-low signal transition.		‡	a	t U28	w U53	z
	M_EDGE_RISING	Specifies to store the time or counter value to the latch upon a low-to-high signal transition.		‡	a	t U28	w U53	z
M_REFERENCE_LATCH_STATE +		Sets the state of the specified reference latch. INQ You must specify a combination value from the following table: To specify which reference latch to affect (summarize) Sets the state of the specified reference latch. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm computer, this function is only available if a MIL Host system was previously allocated. It is not available on a Matrox 4Sight GP.	‡	a
	M_DEFAULT	Same as M_DISABLE.		‡	a	t U28	w U53	z
	M_DISABLE	Specifies the reference latch is disabled.		‡	a	t U28	w U53	z
	M_ENABLE	Specifies the reference latch is enabled.		‡	a	t U28	w U53	z
M_REFERENCE_LATCH_TRIGGER_SOURCE +		Sets which input signal will trigger storing the timestamp or counter value to the specified reference latch. INQ You must specify a combination value from the following table: To specify which reference latch to affect (summarize) Sets which input signal will trigger storing the timestamp or counter value to the specified reference latch. INQ (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] On a Matrox 4Sight GPm computer, this function is only available if a MIL Host system was previously allocated. It is not available on a Matrox 4Sight GP.	‡	a
	M_AUX_IOn	Specifies to use auxiliary input signal n, where n is a number of the auxiliary input signal. (summarize) Specifies to use auxiliary input signal n, where n is a number of the auxiliary input signal. (more details...)		‡	a	t U28	w U53	z
			MIL system specific
			[This is only applicable to Matrox 4Sight GP/GPm platform] For the Matrox 4Sight GPm, n can be a value from 8 to 15.	‡	a
			For the Matrox Concord PoE, n can be a value from 2 to 7.	‡				z
			For the Matrox Indio, n can be a value from 8 to 15.	‡			w U53
			For the Matrox Iris GTR, n can be a value from 3 to 6.	‡		t U28
	M_EXPOSURE	Specifies to route the exposure signal of the camera.		‡		t U28
	M_GRAB_TRIGGER_READY	Specifies to route the internal grab trigger ready signal.		‡		t U28
	M_TIMER_STROBE	Specifies to route the internal timer strobe signal.		‡		t U28
	M_TIMERn	Specifies to use timer n, where n is a number of the timer.		‡	a	t U28	w U53	z

Combination value for the values listed in For controlling an I/O command list reference latch.

You must add the following value to the above-mentioned values to specify which reference latch to affect.

For specifying the reference latch to affect
Combination value	Description		MIL system-specific tooltip (‡)
M_LATCHn	Specifies to affect reference latch n, where n is the latch number. (summarize) Specifies to affect reference latch n, where n is the latch number. (more details...)		‡	a	t U28	w U53	z
		MIL system specific
		[This is only applicable to Matrox 4Sight GP/GPm platform] This is only available on Matrox 4Sight GPm, where n is a number from 1 to 4.	‡	a
		For Matrox Iris GTR, n is a number from 1 to 2.	‡		t U28
		For the Matrox Concord PoE, n can be a value from 1 to 4.	‡				z
		For the Matrox Concord Indio, n can be a value from 1 to 4.	‡			w U53

Compilation information

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