ClassPrefix_GetChannelName

CVI/LabWindows IVI Class Driver

ClassPrefix_GetChannelName

IVI Inherent Function

To form the CLASSPREFIX_ of the function name, use the prefix of the class driver with which you are working. For example, if you are working with the IviDmm class driver, use the prefix IviDmm_ to create the correct function name, IviDmm_GetChannelName.

C Function Prototype

ViStatus ClassPrefix_GetChannelName (ViSession vi, ViInt32 index, ViInt32 bufferSize, ViString name);

Purpose

This function returns the specific driver defined output name that corresponds to the one-based index that you specify. If the value that the user passes for the Index parameter is less than one or greater than the value of the Channel Count attribute, the function returns an empty string in the Name parameter and returns an error.

Parameters

Name   Type   Description
vi ViSession The instrument handle that you obtain from the ClassPrefix_init or ClassPrefix_InitWithOptions functions. The handle identifies a particular IVI session.
index ViInt32 A one-based index that defines which name to return. The index must be less than or equal to the Channel Count attribute.
bufferSize ViInt32 The size of the string buffer passed in to the parameter name.
name ViString Returns the name of the Channel specified by the index parameter.

Return Values