Chapter 6 Function Descriptions

FVolName

MgErr FVolName(path, vol);

Purpose

Creates a path for the volume of an absolute path by removing all but the first component name from path. You can pass the same path variable for the volume path that you use for path. Therefore, you can call this function in the following two ways:

•err = FVolName(path, vol);

/* the parent path is returned in a second path variable */

•err = FVolName(path, path);

/* the parent path writes over the existing path */

Parameters

Name	Type	Description
path	Path	Path whose volume path you want to
		determine.
vol	Path	Parameter in which FVolName stores the
		volume path.

Return Value

mgErr, which can contain the following errors:

mgArgErr

A bad argument was passed to the function. Verify the path.

Using External Code in LabVIEW

6-120

www.ni.com

Chapter 6 Function Descriptions

GetALong

Macro

int32 GetALong(p);

Purpose

Retrieves an int32 from a void pointer. In SPARCstation, this function can retrieve an int32 at any address, even if the int32 is not long word aligned.

Parameters

Name	Type	Description
p	void *	Address from which you want to read an
		int32.

Return Value

int32 stored at the specified address.

© National Instruments Corporation

6-121

Using External Code in LabVIEW

Chapter 6 Function Descriptions

HexChar

int32 HexChar(n);

Purpose

Returns the ASCII character in hex that represents the specified value n, 0 ≤ n ≤ 15.

Parameters

Name	Type	Description
n	int32	Decimal value between 0 and 15.

Return Value

The corresponding ASCII hex character. If n is out of range, the function returns the ASCII character corresponding to n modulo 16.

Using External Code in LabVIEW

6-122

www.ni.com

Chapter 6 Function Descriptions

Hi16

Macro

int16 Hi16(x);

Purpose

Returns the high order int16 of an int32.

Parameters

Name	Type	Description
x	int32	int32 for which you want to determine the
		high int16.

© National Instruments Corporation

6-123

Using External Code in LabVIEW