DioFileGroupSet

Applies To

File

Purpose

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

Syntax

DioFileGroupSet (hFile, pszGroupName, pszGroupChannelsNames, pnStatus)

Parameters

Name
Type
Comments
nFile
SHORT
Session identifier: File handle is used when communicating with a file. The File handle session identifier is returned by calling DioFileOpen.
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 DioFileGroupGetChannelList() for complete example code:

Example

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

 

SHORT hFile, nStatus;

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

 

See Also

DioFileOpen, DioFileClose, DioFileGroupDelete, DioFileGroupGet , DioFileGroupGetChannelList, DioFileGroupGetName, DioGetErrorString