AioSetAiMemorySize

Function

Sets the memory byte size for storing data. This function is used by Z-series only.

Format

Ret = AioSetAiMemorySize ( Id , AiMemorySize )

Parameters

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

AiMemorySize [ VB.NET : Integer ] [ C, C++ : long ] [ C# : int ] [ Python : ctypes.c_long ]
Specifies the memory byte size for storing data.

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.
11820	The value of AiMemorySize is outside the designated range of the function
20001	This function can't be used by this device
20002	Can not use while by another device works To use this function, analog input operation must be stopped.
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.
21820	Can not configure Memory size.

Initial value

AiMemorySize = 1024*1024(1M Byte)

Remarks

This function is used by Z-series only.
You can use this function when the transfer mode of the analog input conversion data is Device buffer mode.
You can not use this function on User buffer mode.

You can confirm the current transfer mode with AioGetAiTransferMode function.

If the device is in operation, the function cannot be performed.

Specifications based on devices

AI-1204Z-PE

AiMemorySize that can be set is 0 to 2147483648 (2GBytes).

AI-1204Z-PCI
AI-1204Z2-PCI

These devices implement bus master transfers with a 32-bit bus width.

Bus master transfers with a 32-bit bus width are subjected to buffer size restrictions depending on the OS used.

The hardware is designed to enable bus master transfers of up to 64MBytes.

However, AiMemorySize cannot be set up to 67108864 (64MBytes) due to OS restrictions. please note.

The details are as follows.

OS used	Range of settings
Microsoft Windows 10 IoT Enterprise 2019 LTSC or later (including Windows 11)	AiMemorySize that can be set is 1 to 2097152 (for 2MBytes).
Microsoft Windows 10 IoT Enterprise LTSB 2016	AiMemorySize that can be set is 1 to 1048576 (for 1MByte).

Example

The memory size is set to 256*1024 byte.

VB.NET	Dim Ret As Integer Ret = AioSetAiMemorySize ( Id , 256*1024)
C, C++	long Ret; Ret = AioSetAiMemorySize ( Id , 256*1024);
C#	int Ret; Ret = aio.SetAiMemorySize ( Id , 256*1024);
Python	Ret = ctypes.c_long() Ret.value = caio.AioSetAiMemorySize ( Id , 256*1024)