MfpgaCommandControl

Reference:

MfpgaCommandAlloc MfpgaCommandInquire MfpgaControl MfpgaInquire MthrControl

Available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Not supported on:

Host system

Matrox CronosPlus

Matrox GPU processing driver

Matrox GigE Vision driver

Matrox IEEE 1394 IIDC driver

Matrox Iris GT

Matrox Morphis

Matrox Morphis QxT

Matrox Orion HD

Matrox USB3 Vision driver (requires Update 19)

Matrox Vio

Fully supported on:

Matrox Radient eCL

Matrox Radient eV-CXP

Matrox Solios eA/XA

Matrox Solios ecl/xcl/ev-cl

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

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP

Available on Matrox Supersight

Function Map

Parameter Associations

Table:

For controlling FPGA Command Settings

Compilation information

None.

MfpgaCommandAlloc

MfpgaCommandFree

Synopsis

Control a specified FPGA command context setting.

Syntax

void MfpgaCommandControl(

MIL_FPGA_CONTEXT FpgaCommandContext,	//in
MIL_INT64 ControlType,	//in
const void *ControlValuePtr	//in

)

Description

This function controls the various settings of the specified FPGA command context. To inquire information about an FPGA command context setting, see MfpgaCommandInquire(). To control or inquire about a general Processing FPGA setting, refer to MfpgaControl() or MfpgaInquire(), respectively.

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

FpgaCommandContext

Specifies the handle of the FPGA command context associated with the PU.

ControlType

Specifies the FPGA command context setting to control.

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

ControlValuePtr

Accepts the address of one of the following (see the Parameter associations section for specifics on which is expected):

MIL_INT

Specifies the address of the variable which contains the value to assign to the command context setting.

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

Parameter associations

The table below lists possible values for the ControlType and ControlValuePtr parameters.

For controlling FPGA Command Settings

Unless otherwise specified, the following values require that you pass the ControlValuePtr parameter the address of a MIL_INT.

For controlling FPGA Command Settings
ControlType		Description	MIL system-specific tooltip (†)
	ControlValuePtr	Description
M_COMPLETION_MODE		Specifies how the processing operation should be issued on the system command queue. Note that this parameter overrides the setting specified using MfpgaCommandAlloc() with the ExecutionMode parameter. INQ (summarize) Specifies how the processing operation should be issued on the system command queue. INQ (more details...)									†	j	k	l	m	p	q	r
	M_DEFAULT	Specifies that the command is queued according to the thread synchronization mode. See MthrControl() with M_THREAD_MODE. (summarize) Specifies that the command is queued according to the thread synchronization mode. (more details...)	†	j	k	l	m	p	q	r
	M_ASYNCHRONOUS	Specifies that, after the command is queued, the thread continues executing without waiting for the operation to complete.	†	j	k	l	m	p	q	r
	M_SYNCHRONOUS	Specifies that, after the command is queued, the thread waits for the processing operation to complete before continuing.	†	j	k	l	m	p	q	r

Compilation information

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