imaq1394GetFeatures
Format
rval = imaq1394GetFeatures (SESSION_ID sessionID, Feature *featureArray, unsigned long *feature_array_size);
Purpose
Retrieves the features supported by the camera. If you do not know in advance the number of features, perform the following steps:
- Call this function with the featureArray parameter set to NULL. The needed size is then stored in feature_array_size.
- Allocate featureArray with the given size.
- Call this function one more time with the previously allocated array.
Parameters
| Parameter | Type | Description |
| sessionID | SESSION_ID | A valid Session ID, which you can obtain with the function imaq1394CameraOpen. |
| featureArray | Feature (passed by reference) | 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 feature_array_size parameter. |
| feature_array_size | unsigned long (passed by reference) | 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.