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

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

See also the HowTo-Guide.

 

Definition

---

NMX_STATUS NMX_Sampling_AddDigiOutByte_1(

 NMX_PHANDLE pHandle,

 unsigned long ulDigiOutByteNo,

 unsigned long* pulNElementsTotal);

 

Parameter

---

pHandle

Connection Handle.

ulDigiOutByteNo

Number of the digital output byte.
The first byte has the number 0.
Example: Having a device with 6 output 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_AddDigiOutByte_1(pHandle, 1, &ulNElements);

 

.Net DLL specific implementation

---

NMX_MSTATUS Sampling_AddDigiOutByte_1(

                 System::IntPtr pHandle,

                 System::UInt32 ulDigiOutByteNo,

                 System::UInt32 %pulNElementsTotal);

 

Comments

---

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

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