<< Click to Display Table of Contents >> Navigation:  NmxDLL Reference Guide > API (programming interface) > Sampling LowLevel (Time-Triggered Realtime Measurement) > NMX_Sampling_AddChannel_1

Use this function to add a single measurement channel to the list of sampling elements.

See also the HowTo-Guide.

 

Definition

---

NMX_STATUS NMX_Sampling_AddChannel_1(

 NMX_PHANDLE pHandle,

 unsigned long ulChannelNumber,

 unsigned long* pulNElementsTotal);

 

Parameter

---

pHandle

Connection Handle.

ulChannelNumber

Number of the measurement channel, which shall be added.
The first channel has the number 0.
Having a device with 24 measurement channels, these are numbered 0..23.

pulNElementsTotal

Total number of sampling elements, which have already been added since the last call of NMX_Sampling_Reset_1.

 

Typical function call (C example)

---

NMX_Sampling_AddChannel_1(pHandle, 5, &ulNElements);

 

.Net DLL specific implementation

---

NMX_MSTATUS Sampling_AddChannel_1(

                 System::IntPtr pHandle,

                 System::UInt32 ulChannelNumber,

                 System::UInt32 %pulNElementsTotal);

 

Comments

---

It is also possible to add all measurement channels to the list of sampling elements (see NMX_Sampling_AddChannelsAll_1).

Please note: the same measurement channel cannot be added twice. Thus you can either use NMX_Sampling_AddChannelsAll_1 or NMX_Sampling_AddChannel_1, but not both of them.