imaq1394GetFeatures2

Format

rval = imaq1394GetFeatures2 (SESSION_ID sessionID, Feature2 *featureArray, unsigned long *featureArraySize);

Purpose

Retrieves the features supported by the camera. If you do not know in advance the number of features, complete the following steps:

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

Parameters

Parameter	Type	Description
sessionId	SESSION_ID	A valid Session ID, which you can obtain using imaq1394CameraOpen2.
featureArray	Feature *	Contains a pointer to an array of feature structure elements in which the features supported by the camera are stored. Set this parameter to NULL to get the size needed by the array in the featureArraySize parameter.
featureArraySize	unsigned long *	Contains the size of the array used to store the features. If the user passes NULL as the featureArray parameter, this parameter contains the needed size.

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.