IviCounter_ConfigureChannelLevel
- Updated2023-02-24
- 1 minute(s) read
ViStatus IviCounter_ConfigureChannelLevel (ViSession instrumentHandle, ViChar _VI_FAR channel[], ViReal64 level, ViReal64 hysteresis);
Purpose
This function configures the IVICOUNTER_ATTR_CHANNEL_LEVEL and IVICOUNTER_ATTR_CHANNEL_HYSTERESIS attributes for a channel.
Parameters
| Input | ||
| Name | Type | Description |
|---|---|---|
| instrumentHandle | ViSession | The ViSession handle that you obtain from the IviCounter_init or IviCounter_InitWithOptions function. The handle identifies a particular instrument session.
Default Value: None |
| channel | ViChar[] | Specifies the name of the channel you want to configure.
Pass the virtual channel name that you assign to the instrument in the IVI Configuration utility. Virtual channel names are aliases for instrument-specific channel strings, which can differ from one instrument to another. With virtual channel names, you can use and swap instruments without having to change the channel names in your source code. Assign a virtual channel name to an instrument-specific channel through the IVI Configuration utility. This parameter accepts virtual channel names you have assigned to the specific instrument you are using and also accepts the instrument-specific channel names. Default Value: "" Note: You can specify the channel name as a string variable or as a literal enclosed in double quotes. |
| level | ViReal64 | Specifies the trigger level you want the counter to use for the channel. The driver uses this value to set the IVICOUNTER_ATTR_CHANNEL_LEVEL attribute. Refer to the attribute description for more information.
Units: volt Default Value: 0.0 |
| hysteresis | ViReal64 | Specifies the hysteresis you want the counter to use for the channel. The driver uses this value to set the IVICOUNTER_ATTR_CHANNEL_HYSTERESIS attribute. Refer to the attribute description for more information.
Units: volt Default Value: 0.65 |