NI-IMAQdx Error: 0xBFF69012 Attribute Value Is Out of Range on GigE Camera

Updated May 25, 2022

Reported In

Driver

  • NI-IMAQdx
  • Vision Acquisition Software

Issue Details

I am connecting to a GigE camera in MAX, the camera is detected, but when I select it I see one of the following errors:
 
Error 0xBFF69012 (or Error -1074360302) Attribute value is out of range
 
Error 0xBFF69012.

 

How do I successfully connect to my camera?

Solution

In newer versions of NI-IMAQdx, this error can display additional information about the attribute that is causing the error.
  • Check the values of the Attribute Name are within range. For example, in the picture above ensure DestinationMulticastAddress is within 0-255 where the attribute value is an IP Address X.X.X.X
Please note that the driver will display the first attribute that is out of range, you may see this again for other attributes after resolving the first.

If connecting the camera for the first time:
When a new GigE camera is detected, an XML file containing the attributes and properties is downloaded from the camera to the NI-IMAQdx camera directory on the computer. If this is your first time connecting the GigE camera and you receive the error “Attribute Value is Out of Range”, there are usually a few reasons for this:
  • The file on the camera itself may be out of date. In this event the camera will need to have its firmware updated.
  • If using a Virtual Machine when receiving this error, try using it on a computer and see if the behaviour is resolved, as we cannot confirm that hardware will work correctly through a Virtual Machine.

To update the camera firmware, contact the manufacturer of the camera or visit their respective support site. Many camera manufacturers will provide a tool to update the firmware to the camera.

After the firmware on the GigE camera has been successfully updated, it’s important to disconnect the camera and delete all the references on the system to the older XML file. 

To delete the references perform the following steps:
  • Windows 10/Windows 7
    1. Navigate to the following directory: 
      <Root>:\Users\Public\Documents\National Instruments\NI-IMAQdx\Data
    2. In the Data folder delete the .iid corresponding to your camera 
    3. Navigate to the XML folder and delete all the .xml files corresponding to the camera.
    4. With all the references removed you may reconnect the camera. It will now download the updated XML file.
  • Windows 2000/XP
    1. Navigate to the following directory: 
      <Root>:\Documents and Settings\All Users\Documents\National Instruments\NI-IMAQdx\Data
    2. In the Data folder delete the .iid corresponding to your camera 
    3. Navigate to the XML folder and delete all the .xml files corresponding to the camera.
    4. With all the references removed you may reconnect the camera. It will now download the updated XML file.
In the event that the problem persists, use the Camera Compatibility Test software provided by NI as described in Camera Validator Compatibility Test for IEEE-1394 and GigE Cameras with NI-IMAQdx to confirm compatibility with NI-IMAQdx.


Or you can ignore this error by changing the value of following attribute to "true".
AcquisitionAttributes::AdvancedGenicam::IgnoreCameraValidationErrors

Please note that you may have a risk by ignoring the errors.