Skip to main content

MsysIoInquire

BoardSupported
Host SystemPartial
V4L2No
Clarity UHDNo
Concord PoEPartial
GenTLNo
GevIQNo
GigE VisionNo
IndioPartial
Iris GTXPartial
Radient eV-CLNo
Rapixo CLNo
Rapixo CoFNo
Rapixo CXPNo
USB3 VisionNo

Inquire about an I/O command list setting.

Syntax

AIL_INT MsysIoInquire(
AIL_ID IoCmdListSysId, //in
AIL_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.

System specific

Board(s)Note
Concord PoE, Host System, IndioOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.

Parameters

IoCmdListSysId (in, AIL_ID)

Specifies the identifier of the I/O command list.

InquireType (in, AIL_INT64)

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

UserVarPtr *(out, void)

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.

Parameter Associations

For inquiring general I/O command list settings

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


M_CLOCK_FREQUENCY

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

System specific

Board(s)Note
Host SystemOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.
ValueDescription
ValueSpecifies the frequency of the I/O command list's clock, in Hz.

M_IO_COMMAND_COUNTER_ACTIVATION

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

System specific

Board(s)Note
Host SystemOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.
ValueDescription
M_DEFAULT
M_ANY_EDGESpecifies to use both a low-to-high and a high-to-low signal transition to increment the I/O command list's internal counter.
M_EDGE_FALLINGSpecifies to use a high-to-low signal transition to increment the I/O command list's internal counter.
M_EDGE_RISING (default)Specifies to use a low-to-high signal transition to increment the I/O command list's internal counter.

M_IO_COMMAND_COUNTER_SOURCE

Inquires the signal to use as the counter source.

System specific

Board(s)Note
Host SystemOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.
ValueDescription
M_DEFAULT
M_AUX_IOnSpecifies to use auxiliary input signal n as the counter source, where n is the number for one of the auxiliary input signals.
M_CLOCK (default)Specifies to use your hardware's clock signal as a counter source.
M_ROTARY_ENCODERnSpecifies to use the output of rotary decoder n as the counter source, where n is the number of the rotary decoder.

M_IO_COMMAND_LIST_NUMBER

Inquires which I/O command list is allocated.

System specific

Board(s)Note
Host SystemOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.
ValueDescription
M_DEFAULT
M_IO_COMMAND_LIST1 (default)Allocates the first I/O command list.
M_IO_COMMAND_LIST2Allocates the second I/O command list.

M_IO_OBJECT_TYPE

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

System specific

Board(s)Note
Host SystemOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.
ValueDescription
M_IO_COMMAND_LISTSpecifies a general I/O command list.

M_OWNER_SYSTEM

Inquires the Aurora Imaging Library identifier (AIL_ID) of the system on which the I/O command list has been allocated.

System specific

Board(s)Note
Host SystemOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.
ValueDescription
M_DEFAULT_HOSTSpecifies the default Host system of the current Aurora Imaging Library application.
System identifierSpecifies a valid system identifier, previously allocated using MsysAlloc.

M_REFERENCE_VALUE

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

System specific

Board(s)Note
Host SystemOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.
ValueDescription
ValueSpecifies the I/O command list's internal counter value.

For inquiring reference latch settings

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


M_REFERENCE_LATCH_ACTIVATION

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

System specific

Board(s)Note
Host SystemOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.
ValueDescription
M_DEFAULT
M_ANY_EDGESpecifies to store the time or counter value to the latch upon both a low-to-high and a high-to-low signal transition.
M_EDGE_FALLINGSpecifies to store the time or counter value to the latch upon a high-to-low signal transition.
M_EDGE_RISING (default)Specifies to store the time or counter value to the latch upon a low-to-high signal transition.

M_REFERENCE_LATCH_STATE

Inquires the state of the specified reference latch.

System specific

Board(s)Note
Host SystemOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.
ValueDescription
M_DEFAULT
M_DISABLE (default)Specifies the reference latch is disabled.
M_ENABLESpecifies the reference latch is enabled.

M_REFERENCE_LATCH_TRIGGER_SOURCE

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

System specific

Board(s)Note
Host SystemOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.
ValueDescription
M_AUX_IOnSpecifies to use auxiliary input signal_n_, where n is a number of the auxiliary input signal.
M_EXPOSURESpecifies to route the exposure signal of the camera.
M_GRAB_TRIGGER_READYSpecifies to route the internal grab trigger ready signal.
M_TIMER_STROBESpecifies to route the internal timer strobe signal.
M_TIMERnSpecifies to use timer_n_, where n is a number of the timer.

M_REFERENCE_LATCH_VALUE

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

System specific

Board(s)Note
Host SystemOn Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.
ValueDescription
ValueSpecifies the last timestamp or counter value stored by the specified reference latch.

Combination Constants — For specifying the reference latch to inquire

Essential, cannot be used alone.

Usage: You must add one of the following values to the above-mentioned values to specify which reference latch to inquire about.

ValueDescription
M_LATCHnSpecifies to inquire about reference latch n, where n is the latch number.

Return Value

Type: AIL_INT

The returned value is the requested information, cast to an AIL_INT. If the requested information does not fit into an AIL_INT, this function will return M_NULLor truncate the information.

On Zebra 4Sight EV6/EV7, this function is only available if an Aurora Imaging Library Host system was previously allocated. It is not available on Zebra 4Sight XV6/XV7.

Copyright © 2026 Zebra Technologies.