|LabWindows/CVI 2010 Help|
|LabWindows/CVI 2012 Help|
|LabWindows/CVI 2013 Help|
|LabWindows/CVI 2015 Help|
|LabWindows/CVI 2017 Help|
|LabWindows/CVI 2019 Help||LabWindows/CVI 2020 Help|
int CNVReadAsync (CNVAsyncReader asynchronousReader);
Asynchronously reads the value of a network variable using an asynchronous reader connection.
When the asynchronous read operation completes, the data callback function for this connection is called with the read value. The first time you call this function, it reads the value the network variable had when the asynchronous reader connected to it. On subsequent calls, this function reads new values of the network variable.
|Note The throughput rate of data with reader and asynchronous reader connections is slower than with subscriber and buffered subscriber connections. If throughput rate is critical to your application, consider using a subscriber or buffered subscriber connection instead.|
|Note To avoid deadlocks, do not call this function in a network variable callback function.|
|Note In this operation, the library flushes all network variable connections in your program for better performance. This also affects writer connections by flushing any pending data.|
|asynchronousReader||CNVAsyncReader||The handle that identifies the network variable asynchronous reader connection.|
|status||int||Return value indicating whether the function was successful. One indicates that a next item was found, zero indicates that a next item was not found, and a negative number indicates that an error occurred.
You can call CNVGetErrorDescription to obtain a string that describes the error.
Library: Network Variable Library
Include file: cvinetv.h
LabWindows/CVI compatibility: LabWindows/CVI 8.1 and later