Table of Contents
Advertisement
6.11 xxusb_ longstack_execute
Executes stack array passed to the function and returns the data read from the VME bus
int xxusb_longstack_execute{
HANDLE hDevice,
void *DataBuffer,
int lDataLen,
int timeout
};
Paramters:
hDevice
[in] Handle to the XX-USB device.
DataBuffer
pointer to the dual use buffer; when calling DataBuffer contains (unsigned short)
stack data, with first word serving as a placeholder, upon successful return,
DataBuffer contains (unsigned short) VME data
lDataLen
The number of bytes to be fetched from VME bus - not less than the actual
number expected, or the function will return -5 code. For stack consisting only of
write operations, lDataLen may be set to 1.
Timeout
The time in ms that should be spent tryimg to write data.
Return Values
When Successful, the number of bytes read from xxusb.
Upon failure, a negative number
Remarks
The function must pass a pointer to an array of unsigned integer stack data, in which the
first word is left empty to serve as a placeholder.
The function is intended for executing long stacks, up to 4 MBytes long, both "write"
and "read" oriented, such as using multi-block transfer operations.
Structure upon call:
DataBuffer(0) = 0(don't care place holder)
DataBuffer(1) = (unsigned short)StackLength bits 0-15
DataBuffer(2) = (unsigned short)StackLength bits 16-20
DataBuffer(3 - StackLength +2) (unsigned short) stack data
StackLength represents the number of words following DataBuffer(1) word, thus the
total number of words is StackLength+2
Structure upon return:
WIENER, Plein & Baus GmbH
42
www.wiener-d.com
Advertisement
Table of Contents
