Filter
Top Products
Chapter 2 Function Reference — DIG_Grp_Status
©
National Instruments Corporation 2-169 NI-DAQ FRM for PC Compatibles
DIG_Grp_Status
Format
status = DIG_Grp_Status (deviceNumber, group, handshakeStatus)
Purpose
Returns a handshake status word indicating whether the specified group is ready to be read
(input group) or written (output group). For the DIO 6533 (DIO-32HS), this function also
initiates the handshaking process if not previously initiated.
Parameters
Input
Output
Parameter Discussion
group is the group whose handshake status is to be obtained.
Range: 1 or 2.
handshakeStatus returns the handshake status of the group. handshakeStatus can be either
0 or 1. The significance of handshakeStatus depends on the configuration of the group. If
the group is configured as an input group, handshakeStatus = 1 indicates that the group has
acquired data and that NI-DAQ can read data from the group. If the group is configured as an
output group, handshakeStatus = 1 indicates that the group is ready to accept output data and
that NI-DAQ can write new data to the group.
Note
C Programmers—handshakeStatus is a pass-by-reference parameter.
Using This Function
DIG_Grp_Status reads the handshake status of the specified group and returns an indication
of the group status in handshakeStatus.
DIG_Grp_Status, along with DIG_Out_Grp and
DIG_In_Grp, facilitates handshaking of digital data between systems. If the specified group
is configured as an input group and
DIG_Grp_Status returns handshakeStatus = 1,
Name Type Description
deviceNumber i16 assigned by configuration utility
group i16 group
Name Type Description
handshakeStatus i16 handshake status