IMAQdxOpenCamera

NI-IMAQdx Function Reference

IMAQdxOpenCamera

Format

rval = IMAQdxOpenCamera (const char *name, IMAQdxCameraControlMode mode, IMAQdxSession *id);

Purpose

Opens a camera, queries the camera for its capabilities, loads a camera configuration file, and creates a unique reference to the camera. Use IMAQdxCloseCamera when you are finished with the reference.

Parameters

Parameter Type Description
name const char * The name of the camera you want to open. name (cam0, cam1, ..., camN) must match the configuration file name you used to configure the camera in MAX. You can also open a camera using its 64-bit serial number (uuid:XXXXXXXXXXXXXXXX), where the number following uuid must be a 64-bit hexadecimal number representing the internal serial number of the camera.
Note   Specify " uuid:serial number in hexadecimal representation" for the camera name when opening in listening mode. The serial number must match the serial number used in MAX.
mode IMAQdxCameraControlMode Camera Control Mode is the control mode of the camera used during image broadcasting. Open a camera in controller mode to actively configure and acquire image data. Open a camera in listener mode to passively acquire image data from a session that was opened in controller mode on a different host or target computer. The default value is Controller.
id IMAQdxSession (passed by reference) On return, a valid Session ID.

Return Value

On success, this function returns IMAQdxErrorSuccess. On failure, this function returns an error code. You can obtain a more detailed error message with IMAQdxGetErrorString or, if you are using Microsoft Visual Basic, IMAQdxGetErrorStringCW.