imaq1394AttributeInquiry

NI-IMAQ for IEEE 1394 Cameras Function

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.