| Cogent C API and Utilities : Version 6.4 | ||
|---|---|---|
 | Cascade DataHub Functions |  |
| Cogent C API and Utilities : Version 6.4 | ||
|---|---|---|
| | Cascade DataHub Functions | |
DH_PointAdd, DH_PointDivide, DH_PointMultiply — modify a point in place, with one message.
#include <cogent.h>
ST_STATUS DH_PointAdd(IP_Task* myself, PT_pCPOINT ppoint, double value, IP_Msg* hmsg, ER_hLIST elist );
ST_STATUS DH_PointDivide(IP_Task* myself, PT_pCPOINT ppoint, double value, IP_Msg* hmsg, ER_hLIST elist );
ST_STATUS DH_PointMultiply(IP_Task* myself, PT_pCPOINT ppoint, double value, IP_Msg* hmsg, ER_hLIST elist );
The task handle associated with this task. This should always be the return value from IP_NserveInit.
A pointer to a Cascade DataHub point structure. All fields are valid, and will be treated by the write, but in the first call on a point the address field must be zero. It will be filled in automatically. This address will be valid so long as the point exists in the DataHub, and if, in subsequent DH_* functions, the address is provided for this point, the function will run slightly faster.
The value to be used to modify the value of the point.
A handle to a previously allocated message structure (using IP_MsgCreate) providing enough buffer space to handle the inter-process communication associated with the DataHub transaction.
A return value containing error information. This is unimplemented in this version, and should be NULL.
These functions give an atomic way to modify a value in the DataHub in place, using a single message. Normally a value is modified in three steps: read, modify, and write. This functions offers a way to modify a value without interference or serialization problems.
The operations provided are as follows:
| DH_PointAdd | Adds the value to the point. |
| DH_PointDivide | Divides the point by the value. |
| DH_PointMultiply | Multiplies the point by the value. |
| |  | |
| DH_ParsePointString |  | DH_ReadPoint, DH_ReadExistingPoint |
Copyright © 1995-2010 by Cogent Real-Time Systems, Inc. All rights reserved.