GxAoArbGetGroupStreamingStatus

Purpose

Returns the group streaming status.

Applies

GX1649-1

Syntax

GxAoArbGetGroupStreamingStatus (nHandle, nGroup, pwStatus, pwCount, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a GX1649 board.
nGroup
SHORT
Group number:
0.   GXAO_GROUPA
1.   GXAO_GROUPB
2.   GXAO_GROUPC
3.   GXAO_GROUPD
pwStatus
PWORD
Returns the a bit field that contains the status of the ARB during streaming operation:
Bit 0: The streaming FIFO is half empty
Bit 1: The streaming FIFO is empty
Bit 2: The streaming FIFO is full
pwCount
PWORD
Returns the total number of samples currently stored in the streaming FIFO. (0 to 1023)
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function returns the status of the streaming FIFO capacity. This can be used to determine when to write to the FIFO when streaming using the polling method (not using interrupts).

Example

The following example writes to the streaming FIFO when the FIFO sample count is below 500:

 

SHORT     nStatus;

WORD      wStatus, wCount;

DOUBLE    dWaveform[500];

BOOL      bRun=TRUE;

 

while (bRun)

{

    GxAoArbGetGroupStreamingStatus(nHandle, GXAO_GROUPB, &wStatus, &wCount, &nStatus);

    if (wCount<500)

          GxAoArbWriteStreaming(nHandle, GXAO_GROUPB, dWaveform, 500, GXAO_1649_WAVEFORM_TYPE_DOUBLE, &nStatus);  

}

 

See Also

GxAoArbEnableGroupStreaming, GxAoArbWriteStreaming, GxAoGetErrorString