IMAQdx Enumerate Cameras VI

NI-IMAQdx VI

previous page next page

IMAQdx Enumerate Cameras VI

Installed With: NI Vision Acquisition Software

Returns a list of all cameras on the host computer.

IMAQdx Enumerate Cameras

Connected Only? (Yes) If the Connected Only? value is Yes, then the Camera Information Array only contains cameras that are currently connected to the host computer. If the Connected Only? value is No, then the Camera Information Array contains cameras that are currently connected, and were previously connected, to the host computer.

error in describes the error status before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. Explain Error (or Explain Warning) gives more information about the error displayed.

	status boolean is either TRUE (X) for an error, or FALSE (checkmark) for no error or a warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
	code input identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
	source string describes the origin of the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Camera Information Array is an array of interface files that are on the host computer. This includes cameras that are currently connected or that were previously connected.

	Type has a value of 3. This designates an NI-IMAQdx interface file.
	Version is the version of the interface file. This number may increment with different versions of the driver as the format of the interface file changes.
	Flags is a bitwise mask of the current interface status. If bit 0 is on (value = 1), the interface represents a camera that is currently connected. If bit 0 is off (value = 0) , the interface represents a disconnected camera.
	SerialNumberHigh is the upper 32-bits of the interface serial number. Every camera has a unique value for SerialNumberHigh.
	SerialNumberLow is the lower 32-bits of the interface serial number. Every camera has a unique value for SerialNumberLow.
	BusType specifies the bus type for the camera.
	InterfaceName is the name of the interface. Use this name when opening the interface.
	VendorName is the vendor name of the camera designated for this interface. VendorName varies from camera to camera.
	ModelName is the model name of the camera designated for this interface. ModelName varies from camera to camera.
	CameraFileName is the name of the camera file that this interface uses. The camera file contains all the settings for a given camera. You can configure and save these settings from Measurement & Automation Explorer (MAX).
	CameraAttributeURL is the URL of the XML file that describes the camera attributes.

error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, error out describes the error status that this VI produces. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

	status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
	code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
	source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

previous page start next page