Ivi_AddToChannelTable
Usage
ViStatus Ivi_AddToChannelTable(ViSession vi, ViChar ChannelStringsToBeAdded[ ]);
Purpose
This function adds additional channel strings to the channel table you establish with Ivi_BuildChannelTable.
Parameters
| Name | Type | Description |
|---|---|---|
| vi | ViSession |
The ViSession handle that you obtain from Ivi_SpecificDriverNew. The handle identifies a particular IVI session. |
| ChannelStringsToBeAdded | ViChar[ ] |
Pass a string containing a the list of additional channel strings you want to add to the channel table. You must separate channel strings with commas. You can include spaces after the commas. For example, to add "3" and "4" as valid channel strings for the instrument session, pass "3, 4". |
Return Value
Contains the status code that the function call returns. IVI engine functions can return error and warning values from several sets of status codes. Some status codes are unique to the IVI engine. Other status codes are the same codes that VISA Library functions return. Still others are error or warning values that functions in specific instrument drivers return. Each set of status codes has its own numeric range.
Regardless of the source of the status code, 0 always indicates success, a positive value indicates a warning, and a negative value indicates an error.