imaq1394GetInterfaceFiles

Format

rval = imaq1394GetInterfaceFiles (InterfaceFile *interfaceFileArray, unsigned long *interfaceFileArraySize);

Purpose

Returns a list of interface files currently on the host computer. If you do not know in advance the number of interfaces, complete the following steps:

1. Call this function with the interfaceFileArray parameter set to NULL. The necessary size is then stored in interfaceFileArraySize.
2. Allocate interfaceFileArraywith the given size.
3. Call this function again using the previously allocated array.

Parameters

Parameter	Type	Description
interfaceFileArray	Interface File *	Contains a pointer to an array of interface files that are on the host computer. This includes cameras that are currently connected or that have been connected in the past. Set this parameter to NULL to get the size needed by the array in the interfaceFileArraySize parameter.
interfaceFileArraySize	unsigned long *	The size of the array used to store the interface files. If the user passes NULL as the interfaceFileArray parameter, this parameter contains the needed size.

Parameter Discussion

The interface file structure contains information about currently and previously connected interfaces. Once enumerated, check the Flags member of the InterfaceFile structure. If the value of Flags is 0, the camera is not currently connected. If the value of Flags is 1, the camera is currently connected.

Return Value

On success, this function returns IMG1394_ERR_GOOD. On failure, this function returns an error code. You can obtain a more detailed error message with imaq1394ShowError.