Chapter 6 Function Descriptions
AZHeapCheck/DSHeapCheck
int32 AZHeapCheck(Bool32 d); int32 DSHeapCheck(Bool32 d);
Purpose
Verifies that the specified heap is not corrupt. This function returns 0 for an intact heap and a nonzero value for a corrupt heap.
Parameters
Name |
Type |
Description |
|
|
|
|
|
|
d |
Bool32 |
Heap you want to verify. |
|
|
|
Return Value
int32, which can contain the following errors:
NoErr |
The heap is intact. |
MCorruptErr |
The heap is corrupt. |
Using External Code in LabVIEW |
6-18 |
www.ni.com |
Chapter 6 Function Descriptions
AZHLock
MgErr AZHLock(h);
Purpose
Locks the memory referenced by the application zone handle h so the memory cannot move. This means the memory manager cannot move the block of memory to which the handle refers.
Do not lock handles more than necessary; it interferes with efficient memory management. Also, do not enlarge a locked handle.
Parameters
Name |
Type |
Description |
|
|
|
|
|
|
h |
UHandle |
Application zone handle you want to lock. |
|
|
|
Return Value
mgErr, which can contain the following errors:
NoErr |
No error. |
mZoneErr |
Handle or pointer not in specified zone. |
© National Instruments Corporation |
6-19 |
Using External Code in LabVIEW |
Chapter 6 Function Descriptions
AZHNoPurge
void AZHNoPurge(h);
Purpose
Marks the memory referenced by the application zone handle h as not purgative.
Parameters
Name |
Type |
Description |
|
|
|
|
|
|
h |
UHandle |
Application zone handle you want to mark as |
|
|
not purgative. |
|
|
|
Using External Code in LabVIEW |
6-20 |
www.ni.com |
Chapter 6 Function Descriptions
AZHPurge
void AZHPurge(h);
Purpose
Marks the memory referenced by the application zone handle h as purgative. This means that in tight memory conditions the memory manager can perform an AZEmptyHandle on h. Use AZReallocHandle to reuse a handle if the manager purges it.
If you mark a handle as purgative, check the handle before using it to determine whether it has become an empty handle.
Parameters
Name |
Type |
Description |
|
|
|
|
|
|
h |
UHandle |
Application zone handle you want to mark as |
|
|
purgative. |
|
|
|
© National Instruments Corporation |
6-21 |
Using External Code in LabVIEW |