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

Use this function to add a single digital input byte to the list of sampling elements.

See also the HowTo-Guide.

 

Definition

---

NMX_STATUS NMX_Sampling_AddDigiInByte_1(

 NMX_PHANDLE pHandle,

 unsigned long ulDigiInByteNo,

 unsigned long* pulNElementsTotal);

 

Parameter

---

pHandle

Connection Handle.

ulDigiInByteNo

Number of the digital input byte.
The first byte has the number 0.
Example: Having a device with 6 input bytes, these are numbered 0..5.

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_AddDigiInByte_1(pHandle, 0, &ulNElements);

 

.Net DLL specific implementation

---

NMX_MSTATUS Sampling_AddDigiInByte_1(

                 System::IntPtr pHandle,

                 System::UInt32 ulDigiInByteNo,

                 System::UInt32 %pulNElementsTotal);

 

Comments

---

It is also possible to add all digital input bytes to the list of sampling elements (see NMX_Sampling_AddDigiInAll_1).

Please note: the same digital input byte cannot be added twice. Thus you can either use NMX_Sampling_AddDigiInAll_1 or NMX_Sampling_AddDigiInByte_1, but not both of them.