GtDio6xFileSetChannelCount

Applies To

GX5296, GX5961, GX5964, File

Purpose

Sets the number of channels associated with a file.

Syntax

GtDio6xFileSetChannelCount (hFile, nChannelCount, 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.
nChannelCount
SHORT
Sets the number of channels associated with a file.
pnStatus
PSHORT
Returned status: 0 on success, negative value on failure.

Comments

This function sets the number of channels associated with a file. Note that calling this function destroys Vector data currently stored in the file object in memory.

Example

The following example opens an existing file, sets the channel count to 32. The file is then closed.

 

SHORT nStatus;

 

GtDio6xFileOpen(“C:\\MyFile.dio6x”, GTDIO6X_FILE_READ_WRITE, &hFile, &nStatus);

GtDio6xFileSetChannelCount(hFile, 32, &nStatus);

GtDio6xFileClose(hFile, &nStatus);

 

See Also

GtDio6xFileOpen, GtDio6xFileClose, GtDio6xFileSetChannelCount, GtDio6xFileSetTimingBoardCount, GtDio6xFileLoad, GtDio6xFileSave, GtDio6xGetErrorString