MfpgaInquire

This function inquires global information about a Processing FPGA, including all loaded PUs. See MfpgaCommandInquire() to retrieve information about a specific command context.

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 Processing FPGA to inquire. 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 about which to inquire, where n can be a value between 0 and the total number of Processing FPGAs-1.	†	j	k	l	m	p	q	r

InquireType

Specifies the information 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):

array of type MIL_INT
array of type MIL_TEXT_CHAR
MIL_INT

Specifies the address at which to write the requested information.

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

Parameter associations

The table below lists possible values for the InquireType parameter and possible values returned to the UserVarPtr parameter.

For FPGAs

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

For FPGAs
InquireType		Description	MIL system-specific tooltip (†)
	UserVarPtr - Possible values returned	Description
M_FPGA_CONFIGURATION_FILENAME		Inquires the string containing identifying information about the file name of the Processing FPGA configuration. The information consists of the location of the file (its path), followed by the name of the file (for example, "C:\mydirectory\myfile"). For a file on the remote computer (under Distributed MIL), the path and file name will be preceded by "remote:///" (for example, "remote:///C:\mydirectory\myfile"). (summarize) Inquires the string containing identifying information about the file name of the Processing FPGA configuration. (more details...)									†	j	k	l	m	p	q	r
	UserVarPtr data type info	Data type: array of type MIL_TEXT_CHAR Array size: Determine the required size using MfpgaInquire() with M_FPGA_CONFIGURATION_FILENAME_LENGTH.	†	j	k	l	m	p	q	r
	MIL_TEXT("String") ¹	Specifies the string containing information about the file name.	†	j	k	l	m	p	q	r
M_FPGA_CONFIGURATION_FILENAME_LENGTH		Inquires the length of the string returned by M_FPGA_CONFIGURATION_FILENAME. (summarize) Inquires the length of the string returned by M_FPGA_CONFIGURATION_FILENAME. (more details...)	†	j	k	l	m	p	q	r
	Value	Specifies the length of the string, including the terminating null character ("\0").	†	j	k	l	m	p	q	r
M_FPGA_PACKAGE_NAME		Inquires the string containing identifying information about the Processing FPGA on your board. The information consists of the specific package name, followed by an underscore, followed by the speed grade. (summarize) Inquires the string containing identifying information about the Processing FPGA on your board. (more details...)	†	j	k	l	m	p	q	r
	UserVarPtr data type info	Data type: array of type MIL_TEXT_CHAR Array size: Determine the required size using MfpgaInquire() with M_FPGA_PACKAGE_NAME_LENGTH.	†	j	k	l	m	p	q	r
	MIL_TEXT("String") ¹	Specifies the string containing information about the Processing FPGA.	†	j	k	l	m	p	q	r
M_FPGA_PACKAGE_NAME_LENGTH		Inquires the length of the string returned by M_FPGA_PACKAGE_NAME. (summarize) Inquires the length of the string returned by M_FPGA_PACKAGE_NAME. (more details...)	†	j	k	l	m	p	q	r
	Value	Specifies the length of the string, including the terminating null character ("\0").	†	j	k	l	m	p	q	r
M_NUMBER_OF_PU		Inquires the number of PUs currently loaded in the Processing FPGA. (summarize) Inquires the number of PUs currently loaded in the Processing FPGA. (more details...)	†	j	k	l	m	p	q	r
	Value	Specifies the number of PUs.	†	j	k	l	m	p	q	r
M_PU_LIST		Inquires the list of function identifiers of all PUs currently loaded in the Processing FPGA. (summarize) Inquires the list of function identifiers of all PUs currently loaded in the Processing FPGA. (more details...)	†	j	k	l	m	p	q	r
	UserVarPtr data type info	Data type: array of type MIL_INT Array size: Determine the required size using MfpgaInquire() with M_NUMBER_OF_PU.	†	j	k	l	m	p	q	r
	Value	Specifies the function identifier.	†	j	k	l	m	p	q	r

¹ If the value was passed in a variable, it won't be returned enclosed in MIL_TEXT().

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.