pdcomm_gem_host_change_constants
Function
Sends a New Equipment Constant Send (S2F15) from a Host.
PdcommStatus pdcomm_gem_host_change_constants(PdcommTcpEndpoint *endpoint, const PdcommGemConstantChange *changes, size_t count, PdcommTcpToken *out_token)The S2F16 reply arrives as #PDCOMM_GEM_RESPONSE with request kind #PDCOMM_GEM_CHANGE_CONSTANTS and outcome #PDCOMM_GEM_CONSTANT_CHANGE_ACK; the EAC is in acknowledgement. An EAC of 0 does not prove that the Equipment physically applied the values.
Parameters
| Name | Description |
|---|---|
endpoint | Host endpoint. |
changes | Array of count ECID/ECV pairs. May be NULL when count is 0. |
count | Number of pairs. |
out_token | Zeroed first; receives the transaction token on success. Must not be NULL. |
Returns
#PDCOMM_OK when the request was queued; #PDCOMM_INVALID_ARGUMENT when endpoint or out_token is NULL, changes is NULL with a nonzero count, or a pair has a NULL or invalid ID or a NULL value; #PDCOMM_LIMIT_EXCEEDED when the message exceeds the Host item limits; #PDCOMM_INVALID_STATE when the endpoint is not a Host or is not Communicating; #PDCOMM_BACKPRESSURE when a TCP event is staged or the pending slots or send queue are full; #PDCOMM_ALLOCATION_FAILED, #PDCOMM_IO_ERROR, or #PDCOMM_POISONED.