MfpgaLoad

This function loads new configuration data into a Processing FPGA on the target system. This function allows you to avoid rebooting the Host and then using the MILConfig utility to specify and MsysAlloc() to load a different FPGA configuration into a Processing FPGA. Loading a new FPGA configuration can take longer to complete than other commands. It is recommended that MfpgaLoad() not be called during a time-critical section of your application. You must wait for all processing to finish executing before loading the new configuration into the Processing FPGA, otherwise data corruption might occur.

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

MilSystemId

Specifies the identifier of the system that has the required Processing FPGA.

FpgaDeviceNumber

Specifies the rank of the Processing FPGA into which to load the new FPGA configuration. This parameter must be set to the following value:

For specifying the rank of the Processing FPGA
Value	Description	MIL system-specific tooltip (†)
M_DEVn	Specifies the rank of the Processing FPGA on the board, where n can be a value between 0 and the total number of Processing FPGAs-1.	†	j	k	l	m	p	q	r

FirmwareFile

Specifies the name and path of the file from which to load the FPGA configuration.

For specifying the file name and path
Value	Description	MIL system-specific tooltip (†)
MIL_TEXT("FileName") ¹	Specifies the drive, directory, and name of the file from which to load the FPGA configuration (for example, "C:\mydirectory\myfile"). To retrieve the file on the remote computer (under Distributed MIL), prefix the specified file name string with "remote:///" (for example, "remote:///C:\mydirectory\myfile"). (summarize) Specifies the drive, directory, and name of the file from which to load the FPGA configuration (for example, "C:\mydirectory\myfile"). (more details...)	†	j	k	l	m	p	q	r

¹ If you are passing the value in a variable, don't enclose it in MIL_TEXT().

ControlFlag

Reserved for future expansion. Set this parameter to M_DEFAULT.

Return value

The returned value is M_VALID if successful. If the operation fails, M_NULL is returned.

Compilation information

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