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:
- Call this function with the featureArray parameter set to NULL. The necessary size is then stored in featureArraySize.
- Allocate featureArray with the given size.
- 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.