Al_getdatatransfermethod – Measurement Computing ADLIB WIN User Manual

Page 60

Advertising
background image

Chapter 16 Logical Device Transfer Methods

15-2

15.2 AL_GetDataTransferMethod

Prototype

C\C++

ERRNUM

AL_GetDataTransferMethod(LHLD

lhld, LPSTR lpstrMethod, long

lMaxLen);


Visual Basic for Windows

Function

AL_GetDataTransferMethod(ByVal

lhld As Long,

ByVal lpstrMethod As String,

ByVal lLength As Long) As Long


LHLD lhld

handle of the LDSD

LPSTR lpstrMode

destination address of the transfer method string

long lMaxLength

the count in bytes to be copied


The AL_GetDataTransferMethod function retrieves the data transfer method of the LDSD.

Parameter

Description

lhld

Identifies the instance of the logical device subsystem.


lpstrMode

Points to the destination string for the copy.


lMaxLength

Maximum length in bytes to be copied to the user string , including the NULL

termination

character.


Returns:
On success ERRNUM is set to 1 and destination string lpstrMethod is set to either
AL_DTM_SOFTWARE, AL_DTM_DMA, AL_DTM_IRQ or AL_DTM_C40PORT as defined in the
ADLIB include file, otherwise ERRNUM contains the last error code that occurred during the call and the
destination string is considered invalid.

Related Functions:
AL_SetDataTransferMethod

Supported Logical Device Subsystems:
Pci55xx

Series:

CTR0,

CTR1,

CTR2,

CTR3

Note that CTR0, CTR1 Counters are referenced in the user manual as CNTR0/1 and

Timers CTR2, CTR3 are referenced in the user manual as TMR0/1.

Pci55xx Series: DIN0 to DIN3, DOT0 to DOT3
Pci55xx Series: ADC0, DAC0, DAC1

Advertising