Chapter 6 Function Descriptions

AZNewHClr/DSNewHClr

UHandle AZNewHClr(size);

UHandle DSNewHClr(size);

Purpose

Creates a new handle to a relocatable block of memory of the specified size and initializes the memory to zero.

Parameters

Name	Type	Description
size	int32	Size, in bytes, of the handle you want to
		create.

Return Value

A handle of the specified size, where the block of memory is set to all zeros. If an error occurs, this function returns NULL.

Using External Code in LabVIEW

6-26

www.ni.com

Chapter 6 Function Descriptions

AZNewPClr/DSNewPClr

UPtr AZNewPClr(size);

UPtr DSNewPClr(size);

Purpose

Creates a new pointer to a non-relocatable block of memory of the specified size and initializes the memory to zero.

Parameters

Name	Type	Description
size	int32	Size, in bytes, of the pointer you want to
		create.

Return Value

A pointer to a block of size bytes filled with zeros. If an error occurs, this function returns

NULL.

© National Instruments Corporation

6-27

Using External Code in LabVIEW

Chapter 6 Function Descriptions

AZNewPtr/DSNewPtr

UPtr AZNewPtr(size);

UPtr DSNewPtr(size);

Purpose

Creates a new pointer to a non-relocatable block of memory of the specified size.

Parameters

Name	Type	Description
size	int32	Size, in bytes, of the pointer you want to
		create.

Return Value

A pointer to a block of size bytes. If an error occurs, this function returns NULL.

Using External Code in LabVIEW

6-28

www.ni.com

Chapter 6 Function Descriptions

AZPtrAndHand/DSPtrAndHand

MgErr AZPtrAndHand(p, h, size);

MgErr DSPtrAndHand(p, h, size);

Purpose

Appends size bytes from the address referenced by p to the end of the memory block referenced by h.

Parameters

Name	Type	Description
p	UPtr	Source of data you want to append to h.
h	UHandle	Handle to which the data of p is appended.
size	int32	Number of bytes to copy from p.

Return Value

mgErr, which can contain the following errors:

NoErr	No error.
MFullErr	Not enough memory to perform the operation.
mZoneErr	Handle or pointer not in specified zone.

© National Instruments Corporation

6-29

Using External Code in LabVIEW