pdcomm_gem_equipment_update_data_variable
함수
데이터 변수 하나의 캐시된 값을 교체합니다.
PdcommStatus pdcomm_gem_equipment_update_data_variable(PdcommTcpEndpoint *endpoint, uint32_t id, const PdcommSecsItem *value)통신 중을 포함해 언제든지 호출할 수 있습니다. 값은 형식, 개수, 항목 한도, 저장소의 값 바이트 예산을 검사한 뒤 복사됩니다. 실패하면 이전 캐시를 유지합니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 장비 엔드포인트입니다. |
id | 데이터 변수 ID(DVID)입니다. |
value | 새 값입니다. 선언된 형식이어야 하며 개수는 선언된 범위 안에 있어야 합니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. endpoint 또는 value가 NULL이거나 값의 형식 또는 개수가 잘못되었으면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. id가 정의되지 않았으면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 값이 항목 한도 또는 max_value_bytes를 넘으면 #PDCOMM_LIMIT_EXCEEDED를 반환합니다. 엔드포인트가 장비가 아니거나 데이터 저장소가 없으면 #PDCOMM_INVALID_STATE를 반환합니다. 그 밖에 #PDCOMM_BACKPRESSURE, #PDCOMM_ALLOCATION_FAILED, #PDCOMM_POISONED를 반환합니다.