<< Click to Display Table of Contents >> Navigation:  NmxDLL Reference Guide > API (programming interface) > Get device information > NMX_GetDigitalOutputInfo_1

This function is used to read information about a digital output byte. Each output byte represents 8 digital output bits.

 

Definition

---

NMX_STATUS NMX_CALLCONV NMX_GetDigitalOutputInfo_1(

 NMX_PHANDLE pHandle,

 unsigned long ulOutputByteNo,

 unsigned long* pulBoxNo,

 unsigned long* pulBoxByteNo);

 

Parameter

---

pHandle

Connection Handle.

ulOutputByteNo

Number of the digital output byte.
The first byte has the number 0.
Example: Having a device with 4 output bytes, these are numbered 0..3.

pulBoxNo

Number of the Box, where the digital outputs are located.

pulBoxByteNo

Number of the digital output byte within its measurement box.
Numbering starts at 1 with each Box.
 
Example: In a system with 2 Boxes à 16 digital outputs, output byte 3 is the 1st output byte of the second box. Thus the value 1 is returned.

 

Typical function call (C example)

---

NMX_GetDigitalOutputInfo_1(pHandle, ulOutByte, &ulBoxNo, &ulBoxByteNo);

 

.Net DLL specific implementation

---

NMX_MSTATUS GetDigitalOutputInfo_1(

                 System::IntPtr pHandle,

                 System::UInt32 ulOutputByteNo,

                 System::UInt32 %pulBoxNo,

                 System::UInt32 %pulBoxByteNo);

 

Comments

---

It is good practice reading the digital output count first. Then read the byte information for each digital output byte.

The function only returns values, if the function return code is NST_SUCCESS. Otherwise the values remain unchanged.