Al_getbufferstatus – Measurement Computing ADLIB WIN User Manual

Page 126

Advertising
background image

Chapter 40 Buffer Handler Functions

27-6

27.6 AL_GetBufferStatus

Prototype

C\C++

ERRNUM

AL_GetBufferStatus(LHLD

lhld,

LPDATABUFFSTATUS

lpDataBuffStat,

long lBuffNum);


Visual Basic for Windows

Function

AL_

GetBufferStatus(ByVal

lhld As Long,

lpDataBuffStat As LPDATABUFFSTATUS,

ByVal lBuffNum As Long) As Long

LHLD lhld

handle

of

the

LDSD


LPDATABUFFSTATUS
lpDataBuffStat

address of the LPDATABUFFSTATUS structure


long
lBuffNum

specifies

the

buffer

number


The AL_ GetBufferStatus function retrieves a buffer’s current status.

Parameter

Description

lhld

Identifies the instance of the logical device subsystem.


lpDataBuffStat

Points to the data buffer status structure to be filled.


lBuffNum

Specifies the ID number of the buffer from which the status information is

obtained.

DONE_BUFFER

Gets the next available buffer


Returns:
On success lpDataBuffStat is set with the specified lBuffNum or the next available buffer status, otherwise
ERRNUM contains the last error code that occurred during the call. If lBuffNum is set to DONE_BUFFER
a return value of 0 indicates the buffer is incomplete, a return value of 1 indicates the buffer is complete.

Related Functions:
AL_ClearBufferDoneFlag

Supported Logical Device Subsystems:
Pci55xx Series: ADC0, DAC0, DAC1

Advertising