DAQmxCreateAIThrmcplChan
int32 DAQmxCreateAIThrmcplChan (TaskHandle taskHandle, const char
physicalChannel[], const char nameToAssignToChannel[], float64 minVal, float64 maxVal, int32 units, int32 thermocoupleType, int32 cjcSource, float64 cjcVal, const char cjcChannel[]);
Purpose
Creates channel(s) that use a thermocouple to measure temperature and adds the channel(s) to the task you specify with taskHandle.
Parameters
|
Input
|
| Name |
Type |
Description |
|
taskHandle
|
TaskHandle |
The task to which to add the channels that this function creates. |
|
physicalChannel
|
const char []
|
The names of the physical channels to use to create virtual channels. You can specify a list or range of physical channels. |
|
nameToAssignToChannel
|
const char []
|
The name(s) to assign to the created virtual channel(s). If you do not specify a name, NI-DAQmx uses the physical channel name as the virtual channel name. If you specify your own names for nameToAssignToChannel, you must use the names when you refer to these channels in other NI-DAQmx functions.
If you create multiple virtual channels with one call to this function, you can specify a list of names separated by commas. If you provide fewer names than the number of virtual channels you create, NI-DAQmx automatically assigns names to the virtual channels. |
|
minVal
|
float64 |
The minimum value, in units, that you expect to measure. |
|
maxVal
|
float64 |
The maximum value, in units, that you expect to measure. |
|
units
|
int32 |
The units to use to return the measurement.
| Name |
|
Description |
|
DAQmx_Val_DegC
|
|
degrees Celsius |
|
DAQmx_Val_DegF
|
|
degrees Fahrenheit |
|
DAQmx_Val_Kelvins
|
|
kelvins |
|
DAQmx_Val_DegR
|
|
degrees Rankine |
|
|
thermocoupleType
|
int32 |
The type of thermocouple connected to the channel.
| Value |
|
Description |
|
DAQmx_Val_J_Type_TC
|
|
J-type thermocouple. |
|
DAQmx_Val_K_Type_TC
|
|
K-type thermocouple. |
|
DAQmx_Val_N_Type_TC
|
|
N-type thermocouple. |
|
DAQmx_Val_R_Type_TC
|
|
R-type thermocouple. |
|
DAQmx_Val_S_Type_TC
|
|
S-type thermocouple. |
|
DAQmx_Val_T_Type_TC
|
|
T-type thermocouple. |
|
DAQmx_Val_B_Type_TC
|
|
B-type thermocouple. |
|
DAQmx_Val_E_Type_TC
|
|
E-type thermocouple. |
|
|
cjcSource
|
int32 |
The source of cold junction compensation.
| Value |
|
Description |
|
DAQmx_Val_BuiltIn
|
|
Use a cold-junction compensation channel built into the terminal block. |
|
DAQmx_Val_ConstVal
|
|
You must specify the cold-junction temperature. |
|
DAQmx_Val_Chan
|
|
Use a channel for cold-junction compensation. |
|
|
cjcVal
|
float64 |
The temperature of the cold junction of the thermocouple if you set cjcSource to DAQmx_Val_ConstVal. |
|
cjcChannel
|
const char []
|
The channel that acquires the temperature of the thermocouple cold-junction if you set cjcSource to DAQmx_Val_Chan. You can use a global channel or another virtual channel already in the task. If the channel is a temperature channel, NI-DAQmx acquires the temperature in the correct units. Other channel types, such as a resistance channel with a custom sensor, must use a custom scale to scale values to degrees Celsius. |
Return Value
| Name |
Type |
Description |
|
status
|
int32 |
The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error. |