beautypg.com

Al_setburstlength – Measurement Computing ADLIB WIN User Manual

Page 92

background image

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).