Sensoray 817 - Manual (Page 8)

8
int width;
int height;
} CAP_BUFFER;
Defines the capture buffer structure. Capture buffers are allocated by the driver in the
host’s RAM. The driver allocates multiple (currently 4) buffers per capture channel.
Once the requested captured images are transferred to a capture buffer, the buffer is
marked as busy and an application may access the data using the pointers defined in
CAP_BUFFER. The driver does not copy any image data, just provides the proper pointer
values.
An application has to release the buffer promptly (see
S817_ReleaseBuffer function),
so that the board can transfer the data to the host.
bufId
Buffer index. The value of bufId is set by the driver and is used by an application
when a buffer is being released back.
pData
A pointer to image data, which may be JPEG or bitmap data depending on the
requested data type. The actual size of the data and its validity are indicated in the
capture status structure pointed to by
pStat .
pStat
A pointer to status data. See CAP_STAT structure.
width, height
Image dimensions based on the selected image size (see VIDEO_MODE structure).
Those values are inserted by the driver.
CAP_STAT
typedef struct {
int
board;
int chanId;
int bufId;
int capType;
int videopresent;
int valid;
int jpgsize;
int tick;
int frameCnt;
int
reserved[4];
} CAP_STAT;
Defines capture status structure. Capture status is returned with each captured buffer
(see
CAP_BUFFER structure).
board
Index of the board that the buffer was captured from (1 .. SYS_MAXBOARDS , see
s817.h ).
chanId