| MIL 10 Reference
| Customize Help
| Save Settings

MsysIoControl


See also
Availability
Available in MIL-Lite
Available in MIL

Available on Windows
Available on Linux

Not supported on:
Not supported on Matrox CronosPlus
Not supported on Matrox GPU processing driver
Not supported on Matrox GigE Vision driver
Not supported on Matrox IEEE 1394 IIDC driver
Not supported on Matrox Iris GT
Not supported on Matrox Morphis
Not supported on Matrox Morphis QxT
Not supported on Matrox Orion HD
Not supported on Matrox Radient eCL
Not supported on Matrox Radient eV-CXP
Not supported on Matrox Solios eA/XA
Not supported on Matrox Solios ecl/xcl/ev-cl
Not supported on Matrox USB3 Vision driver (requires Update 19)
Not supported on Matrox Vio
Fully supported on:
Fully supported on Host system

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
Not available on Non-Matrox computer
Available on Matrox 4Sight GP
function map Function map
Examples
MsysIoCommandRegister
MsysIoFree
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]

This function is only available on Matrox 4Sight GPm.

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.

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

function map For controlling I/O command list settings
CollapseControlType Description
MIL system-specific
tooltip (†)
ControlValue
Collapse 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)
† a
Collapse M_DEFAULT

Same as M_EDGE_RISING.

 † a
Collapse M_EDGE_FALLING

Specifies to use a high-to-low signal transition to increment the I/O command list's internal counter.

 † a
Collapse M_EDGE_RISING

Specifies to use a low-to-high signal transition to increment the I/O command list's internal counter.

 † a

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.

function map For controlling an I/O command list reference latch
CollapseControlType Description
MIL system-specific
tooltip (†)
ControlValue
Collapse 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:
(summarize)
† a
Collapse M_DEFAULT

Same as M_EDGE_RISING.

 † a
Collapse 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
Collapse M_EDGE_FALLING

Specifies to store the time or counter value to the latch upon a high-to-low signal transition.

 † a
Collapse M_EDGE_RISING

Specifies to store the time or counter value to the latch upon a low-to-high signal transition.

 † a
Collapse M_REFERENCE_LATCH_STATE +

Sets the state of the specified reference latch. INQ


You must specify a combination value from the following table:
(summarize)
† a
Collapse M_DEFAULT

Same as M_DISABLE.

 † a
Collapse M_DISABLE

Specifies the reference latch is disabled.

 † a
Collapse M_ENABLE

Specifies the reference latch is enabled.

 † a
Collapse 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:
(summarize)
† a
Collapse M_AUX_IOn

Specifies to use auxiliary input signal n, where n is a number of the auxiliary input signal.

 † a
Combination constant 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.

function map For specifying the reference latch to affect
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_LATCHn

Specifies to affect reference latch n, where n is a number from 1 to 4.

 † a
Compilation information
Header Include mil.h.
Library Use mil.lib.
DLL Requires mil.dll.
IO COMMAND COUNTER ACTIVATION DEFAULT EDGE FALLING EDGE RISING REFERENCE LATCH ACTIVATION DEFAULT ANY EDGE EDGE FALLING EDGE RISING REFERENCE LATCH STATE DEFAULT DISABLE ENABLE REFERENCE LATCH TRIGGER SOURCE AUX IOn LATCHn