imaq1394AttributeInquiry
Format
rval = imaq1394AttributeInquiry(SESSION_ID sessionId, unsigned long attribute, unsigned long *minimumValue, unsigned long *maximumValue, unsigned long *readable, unsigned long *autoMode, unsigned long *enable);
Purpose
Determines if the camera supports the specified attribute. If so, the function returns information about the attribute, including minimum and maximum values, whether the attribute can be read, and if the attribute can be set in automatic mode.
Parameters
Parameter | Type | Description |
sessionID | SESSION_ID | A valid Session ID, which you can obtain with the function imaq1394CameraOpen. |
attribute | unsigned long | Specifies the attribute whose information you want to query. |
minimumValue | unsigned long (passed by reference) | Minimum value of the attribute if it is supported by the camera (if enable is set to TRUE). Set this parameter to NULL if you do not need the return value. |
maximumValue | unsigned long (passed by reference) | Maximum value of the attribute if it is supported by the camera (if enable is set to TRUE). Set this parameter to NULL if you do not need the return value. |
readable | unsigned long (passed by reference) | Set to TRUE if the software can read the value of the specified attribute. Set this parameter to NULL if you do not need the return value. |
autoMode | unsigned long (passed by reference) | Set to TRUE if the value of the specified attribute can be set to automatic mode. Set this parameter to NULL if you do not need the return value. To set an attribute in automatic mode, set its value to IMAQ1394_AUTOMODE using imaq1394SetAttribute. |
enable | unsigned long (passed by reference) | Set to TRUE if the camera supports the specified attributes. |
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 or imaq1394ShowErrorCW, if you are using Microsoft Visual Basic.