imaq1394CameraOpen2

Format

rval = imaq1394CameraOpen2(char *name, unsigned long mode, SESSION_ID *sessionId);

Purpose

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

Parameters

Parameter	Type	Description
name	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	Unsigned long	The control mode of the camera used during image broadcasting. Open a camera using IMG1394_CAMERA_MODE_CONTROLLER to actively configure and acquire image data. Open a camera on a different host or target computer using IMG1394_CAMERA_MODE_LISTENER to passively acquire image data from a session that was opened in controller mode.
sessionId	SESSION_ID *	On return, a valid Session ID.

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, if you are using Microsoft Visual Basic, imaq1394ShowErrorCW.