Aim MIL-STD-1553 - Apicmdsysmalloc

MIL-STD-1553 Reference Manual
107
Chapter 3 – System Functions
3.1.21 ApiCmdSysMalloc
Prototype:
AiInt16 ApiCmdSysMalloc( AiUInt32 ul_Module, AiUInt8 uc_MemType,
AiUInt32 ul_Size, AiUInt32 ul_Tag,
AiUInt32* pul_Offset );
Driver Command:
MIL_COM_MALLOC (0x01000003)
Purpose:
Allocate a memory block with the given size in the given memory. This function is
currently only implemented on AEC/AXC/AMCX1553 boards for update purpose. Only
global memory is accepted and the function will always return an offset of 16MB.
Input
A
A
i
i
U
U
I
I
n
n
t
t
8
8
u
u
c
c
_
_
M
M
e
e
m
m
T
T
y
y
p
p
e
e
The memory type from where the block should be allocated.
Value
Define
Description
0
API_MEMTYPE_GLOBAL
Global memory
1
API_MEMTYPE_SHARED
Shared memory
2
API_MEMTYPE_LOCAL
Local memory
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
u
u
l
l
_
_
S
S
i
i
z
z
e
e
The size of the memory block.
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
u
u
l
l
_
_
T
T
a
a
g
g
Name of the request for debug and bug check purpose.
Output
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
*
*
p
p
u
u
l
l
_
_
O
O
f
f
f
f
s
s
e
e
t
t
The offset where the allocated buffer starts.
Return Value
A
A
i
i
I
I
n
n
t
t
1
1
6
6
All API functions return API_OK if no error occurred. If the return value is not equal
to API_OK the function ApiGetErrorDescription can be used to obtain an error
description.