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