pdcomm_gem_host_change_constants
함수
호스트에서 New Equipment Constant Send(S2F15)를 보냅니다.
PdcommStatus pdcomm_gem_host_change_constants(PdcommTcpEndpoint *endpoint, const PdcommGemConstantChange *changes, size_t count, PdcommTcpToken *out_token)S2F16 응답은 요청 종류 #PDCOMM_GEM_CHANGE_CONSTANTS, 결과 유형 #PDCOMM_GEM_CONSTANT_CHANGE_ACK인 #PDCOMM_GEM_RESPONSE로 도착하며, EAC는 acknowledgement에 들어 있습니다. EAC가 0이라고 해서 장비가 값을 물리적으로 적용했다는 뜻은 아닙니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 호스트 엔드포인트입니다. |
changes | count개의 ECID/ECV 쌍 배열입니다. count가 0이면 NULL일 수 있습니다. |
count | 쌍의 개수입니다. |
out_token | 먼저 0으로 초기화되며, 성공하면 트랜잭션 토큰을 받습니다. NULL이 아니어야 합니다. |
반환값
요청을 큐에 넣었으면 #PDCOMM_OK를 반환합니다. endpoint 또는 out_token이 NULL이거나, count가 0이 아닌데 changes가 NULL이거나, 쌍의 ID가 NULL이거나 유효하지 않거나 값이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 메시지가 호스트 항목 한도를 넘으면 #PDCOMM_LIMIT_EXCEEDED를 반환합니다. 엔드포인트가 호스트가 아니거나 Communicating 상태가 아니면 #PDCOMM_INVALID_STATE를 반환합니다. 준비된 TCP 이벤트(staged event)가 있거나 대기 슬롯 또는 송신 큐가 가득 차면 #PDCOMM_BACKPRESSURE를 반환합니다. 그 밖에 #PDCOMM_ALLOCATION_FAILED, #PDCOMM_IO_ERROR, #PDCOMM_POISONED를 반환합니다.