AioGetAoSamplingCount


Function

Retrieves the generated count of the analog output.

Format

Ret = AioGetAoSamplingCount ( ID , AoSamplingCount )

Parameters

Id [ VB.NET : Short ] [ C, C++ : short ] [ C# : short ] [ Python : ctypes.c_short ]
Specifies the ID retrieved from AioInit function.

AoSamplingCount [ VB.NET : Integer ] [ C, C++ : long * ] [ C# : out int ] [ Python : ctypes.POINTER(ctypes.c_long) ]
Specifies the address of the variable that stores the generating count.

Return value

Ret [ VB.NET : Integer ] [ C, C++ : long ] [ C# : int ] [ Python : ctypes.c_long ]

Return values

Content

0

Normality completion

7

Execute AioResetDevice function because the device has recovered from standby mode

10001

Invalid Id was specified
Use the Id retrieved from AioInit to specify the Id in this function.

10002

AIO driver can't be called
At first, perform AioInit function.

13400

Pointer to AoSamplingCount is NULL
Specify the address of variable to parameter.

20001

This function can't be used by this device

20003

Can not use because another process is using the device
When another process is using the device, all functions except for those that support multi-process can not be performed.

Initial value

In all devices, AoSamplingCount = 0

Remarks

You can retrieve the generated count of the analog output feature.
You may also refer this number as indicating the index of device buffer.

Resets this value to 0 by calling AioResetAoMemory function.

Stores the generating counts of all channels used in the AioStartAo.
This function can be executed even if the device is in operation.
This function cannot be used on devices without the analog output function.

Please use the AioGetAoSamplingTimes function when you need the remain numbers of generating on device buffer.

For example, you specify 2000 data for device buffer and your device has already generated 500 data out of 2000 data.
You may have the following number with 2nd argument of each functions at that time.

AioGetAoSamplingCounts : AoSamplingCount = 500
AioGetAoSamplingTimes : AoSamplingTimes = 1500

 

Example

Retrieves the generating count (location) from the device memory (software memory).

VB.NET

Dim Ret As Integer
Dim AoSamplingCount As Integer
Ret = AioGetAoSamplingCount ( Id , AoSamplingCount )
 

C, C++

long Ret;
long AoSamplingCount;
Ret = AioGetAoSamplingCount ( Id , &AoSamplingCount );
 

C#

int Ret;
int AoSamplingCount;
Ret = aio.GetAoSamplingCount ( Id , out AoSamplingCount );
 

Python

Ret = ctypes.c_long()
AoSamplingCount = ctypes.c_long()
Ret.value = caio.AioGetAoSamplingCount ( Id , ctypes.byref(AoSamplingCount) )