| Customize Help
| Save Settings

MsysIoInquire


Function Map
Syntax
Description
Parameters
- IoCmdListSysId
- InquireType
- UserVarPtr
Parameter Associations
Table: For inquiring general I/O command list settings
Table: For inquiring reference latch settings
+ combination: For specifying the reference latch to inquire
Return value
Compilation information
Synopsis
Inquire about an I/O command list setting.
Syntax
MIL_INT MsysIoInquire(
MIL_ID IoCmdListSysId, //in
MIL_INT64 InquireType, //in
void *UserVarPtr //out
)
Description

This function inquires about the specified I/O command list setting.

Note that you can use MsysIoControl() to control specific I/O command list settings.

[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.

InquireType

Specifies the type of I/O command list setting about which to inquire.

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):
  • MIL_DOUBLE
  • MIL_ID
  • MIL_INT
  • MIL_INT64

Specifies the address in which to write the requested information. Since the MsysIoInquire() 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.

The following inquire types allow you to inquire general I/O command list settings.

function map For inquiring general I/O command list settings
Click to summarizeInquireType Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_CLOCK_FREQUENCY

Inquires the frequency of the I/O command list's clock signal.

(summarize)
‡ 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
 ‡ a t
U28		 w
U53		 z
Click to summarize Value

Specifies the frequency of the I/O command list's clock, in Hz.

 ‡ a t
U28		 w
U53		 z
Click to summarize M_IO_COMMAND_COUNTER_ACTIVATION

Inquires which edge of the source signal is used to increment the I/O command list's internal counter. SET

(summarize)
‡ 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
 ‡ a t
U28		 w
U53		 z
Click to summarize 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
Click to summarize 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
Click to summarize 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
Click to summarize M_IO_COMMAND_COUNTER_SOURCE

Inquires the signal to use as the counter source. SET

(summarize)
‡ 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
 ‡ a t
U28		 w
U53		 z
Click to summarize M_AUX_IOn

Specifies to use auxiliary input signal n as the counter source, where n is the number for one of the auxiliary input signals. INFO

 ‡ a t
U28		 w
U53		 z
Click to summarize M_CLOCK

Specifies to use your hardware's clock signal as a counter source. INFO

 ‡ a t
U28		 w
U53		 z
Click to summarize M_ROTARY_ENCODERn

Specifies to use the output of rotary decoder n as the counter source, where n is the number of the rotary decoder. INFO

 ‡ a t
U28		 w
U53		 z
Click to summarize M_IO_COMMAND_LIST_NUMBER

Inquires which I/O command list is allocated. SET

(summarize)
‡ 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
 ‡ a t
U28		 w
U53		 z
Click to summarize M_IO_COMMAND_LIST1

Specifies the first I/O command list.

 ‡ a t
U28		 w
U53		 z
Click to summarize M_IO_COMMAND_LIST2

Specifies the second I/O command list.

 ‡ a w
U53		 z
Click to summarize M_IO_OBJECT_TYPE

Inquires the type of I/O command list that is allocated. SET

(summarize)
‡ 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
 ‡ a t
U28		 w
U53		 z
Click to summarize M_IO_COMMAND_LIST

Specifies a general I/O command list.

 ‡ a t
U28		 w
U53		 z
Click to summarize M_OWNER_SYSTEM

Inquires the MIL identifier (MIL_ID) of the system on which the I/O command list has been allocated. SET

(summarize)
‡ 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_ID
 ‡ a t
U28		 w
U53		 z
Click to summarize M_DEFAULT_HOST

Specifies the default Host system of the current MIL application.

 ‡ a
Click to summarize MIL system identifier

Specifies a valid system identifier, previously allocated using MsysAlloc(). INFO

 ‡ a t
U28		 w
U53		 z
Click to summarize M_REFERENCE_VALUE

Inquires the I/O command list's internal counter value at the current moment (that is, the moment MsysIoInquire() is called).

(summarize)
‡ 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64 MORE
 ‡ a t
U28		 w
U53		 z
Click to summarize Value

Specifies the I/O command list's internal counter value.

 ‡ a t
U28		 w
U53		 z

The following inquire types allow you to inquire settings for one of the I/O command list's reference latches.

function map For inquiring reference latch settings
Click to summarizeInquireType Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_REFERENCE_LATCH_ACTIVATION +

Inquires the signal transition upon which to store the time or counter value to the specified reference latch. SET


You must specify a combination value from the following table:
(summarize)
‡ 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
 ‡ a t
U28		 w
U53		 z
Click to summarize 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
Click to summarize 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
Click to summarize 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
Click to summarize M_REFERENCE_LATCH_STATE +

Inquires the state of the specified reference latch. SET


You must specify a combination value from the following table:
(summarize)
‡ 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
 ‡ a t
U28		 w
U53		 z
Click to summarize M_DISABLE

Specifies the reference latch is disabled.

 ‡ a t
U28		 w
U53		 z
Click to summarize M_ENABLE

Specifies the reference latch is enabled.

 ‡ a t
U28		 w
U53		 z
Click to summarize M_REFERENCE_LATCH_TRIGGER_SOURCE +

Inquires which input signal will trigger storing the time or counter value to the specified reference latch. SET


You must specify a combination value from the following table:
(summarize)
‡ 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
 ‡ a t
U28		 w
U53		 z
Click to summarize M_AUX_IOn

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

 ‡ a t
U28		 w
U53		 z
Click to summarize M_EXPOSURE

Specifies to route the exposure signal of the camera.

 ‡ t
U28
Click to summarize M_GRAB_TRIGGER_READY

Specifies to route the internal grab trigger ready signal.

 ‡ t
U28
Click to summarize M_TIMER_STROBE

Specifies to route the internal timer strobe signal.

 ‡ t
U28
Click to summarize M_TIMERn

Specifies to use timer n, where n is a number of the timer.

 ‡ a t
U28		 w
U53		 z
Click to summarize M_REFERENCE_LATCH_VALUE +

Inquires the last time or counter value stored by the specified reference latch.


You must specify a combination value from the following table:
(summarize)
‡ 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64 MORE
 ‡ a t
U28		 w
U53		 z
Click to summarize Value

Specifies the last timestamp or counter value stored by the specified reference latch.

 ‡ a t
U28		 w
U53		 z
Combination value for the values listed in For inquiring reference latch settings.

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

function map For specifying the reference latch to inquire
Click to summarizeCombination value Description MIL system-specific
tooltip (‡)
Click to summarize M_LATCHn

Specifies to inquire about reference latch n, where n is the latch number. INFO

 ‡ a t
U28		 w
U53		 z
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.
CLOCK FREQUENCY IO COMMAND COUNTER ACTIVATION ANY EDGE EDGE FALLING EDGE RISING IO COMMAND COUNTER SOURCE AUX IOn CLOCK ROTARY ENCODERn IO COMMAND LIST NUMBER IO COMMAND LIST1 IO COMMAND LIST2 IO OBJECT TYPE IO COMMAND LIST OWNER SYSTEM DEFAULT HOST REFERENCE VALUE REFERENCE LATCH ACTIVATION ANY EDGE EDGE FALLING EDGE RISING REFERENCE LATCH STATE DISABLE ENABLE REFERENCE LATCH TRIGGER SOURCE AUX IOn EXPOSURE GRAB TRIGGER READY TIMER STROBE TIMERn REFERENCE LATCH VALUE LATCHn M_AUX_IOn M_ROTARY_ENCODERn M_AUX_IOn M_TIMERn M_LATCHn