GtDio6xFileGroupSet

Applies To

File

Purpose

Add new group name and the channels names string to the file.

Syntax

GtDio6xFileGroupSet (hFile, pszGroupName, pszGroupChannelsNames, pnStatus)

Parameters

Name
Type
Comments
hFile
SHORT
Session identifier: File handle is used when communicating with a file. The File handle session identifier is returned by calling GtDio6xFileOpen.
pszGroupName
PCSTR
String specifying group name.
pszGroupChannelsNames
PCSTR
String specifying group’s channels names.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function adds new group name and the channels names string to the file.

The pszGroupChannelsNames uses semicolons between channles name in the string, e.g. the following group’s channels names string "RESET;CLK_IN;CLK_OUT;SOURCE;GND;" has 5 channels names.

See GtDio6xFileGroupGetChannelList() for complete example code:

Example

The following example adds “Group1” and channels names string to the file:

 

SHORT hFile, nStatus;

GtDio6xFileGroupSet (hFile, “Group1”, "RESET;CLK_IN;CLK_OUT;SOURCE;GND;", &nStatus);

 

See Also

GtDio6xFileOpen, GtDio6xFileSave, GtDio6xFileGroupDelete , GtDio6xFileGroupGet, GtDio6xFileGroupGetChannelList, GtDio6xFileGroupGetName , GtDio6xGetErrorString