GtDio6xFileGetChannelCount

Applies To

GX5296, GX5961, GX5964, File

Purpose

Gets the number of channels associated with a file.

Syntax

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

Comments

This function gets 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, gets the channel count. The file is then closed.

 

SHORT nStatus, nChannelCount;

 

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

GtDio6xFileGetChannelCount(hFile, &nChannelCount, &nStatus);

GtDio6xFileClose(hFile, &nStatus);

 

See Also

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