Al_setburstlength – Measurement Computing ADLIB WIN User Manual
Page 92

Chapter 23 Burst Modes
22-2
22.2 AL_SetBurstLength
Prototype
C\C++
ERRNUM
AL_SetBurstLength(LHLD
lhld, long lBurstSamples);
Visual Basic for Windows
Function
AL_SetBurstLength(ByVal
lhld As Long,
ByVal lBurstSamples As Long) As Long
LHLD lhld
handle of the LDSD
long lBurstSamples
specifies the number of burst samples
The AL_SetBurstLength function sets the number of samples obtained during a burst in the LDSD. This
function is made available for hardware devices that provide burst length mechanism. When the hardware
device starts a burst, it provides (n) more samples, and then stops. The Burst samples specify the number of
data samples to be obtained after a valid hardware burst trigger.
Parameter
Description
lhld
Identifies the instance of the logical device subsystem.
lBurstSamples
Sets the number of samples to be obtained after a Burst has been received. The
available range is device independent and is verified by ADLIB against the
min./max. burst length specified in the device's capabilities file.
Returns:
On success ERRNUM is set to 1, otherwise ERRNUM contains the last error code that occurred during the
call.
Related Functions:
AL_SetBurstMode
AL_SetBurstRate
AL_GetBurstStruct
Supported Logical Device Subsystems:
Pci55xx Series: ADC0, Options:
valid values are from 1 to 65535 where the actual Burst Length is set to
(65536 - lBurstSamples).