imaq1394ReadBlock

NI-IMAQ for IEEE 1394 Cameras Function

imaq1394ReadBlock

Format

rval = imaq1394ReadBlock(SESSION_ID sessionId, unsigned long offset, unsigned long count, unsigned long *array);

Purpose

Accesses registers on the camera and reads an array of contiguous 32-bit quadlets from the camera. Data is byte-swapped for little endian alignment after transfer.

Parameters

Parameter Type Description
sessionId SESSION_Id A valid Session ID, which you can obtain using imaq1394CameraOpen2.
Offset unsigned long The register location to access. Use IMG1394_ATTR_BASE_ADDRESS to obtain the base register for the camera. Refer to the camera documentation for more information about camera-specific register ranges.
Count unsigned long The number of 32-bit quadlets to read.
Array unsigned longĀ * On return, the array of 32-bit quadlets returned from the camera.

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.