pdcomm_gem_equipment_data_get
함수
데이터 변수 하나의 이름, 단위, 캐시된 값을 복사합니다.
PdcommStatus pdcomm_gem_equipment_data_get(PdcommTcpEndpoint *endpoint, uint32_t id, uint32_t field, PdcommSecsItem **out_item)#PDCOMM_GEM_DATA_NAME과 #PDCOMM_GEM_DATA_UNITS는 소유한 ASCII 항목을 반환합니다. #PDCOMM_GEM_DATA_CACHED는 캐시된 값의 소유 사본을 반환하며, 캐시된 값이 없으면 *out_item을 NULL로 두고 #PDCOMM_OK를 반환합니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 장비 엔드포인트입니다. |
id | 데이터 변수 ID(DVID)입니다. |
field | #PDCOMM_GEM_DATA_NAME, #PDCOMM_GEM_DATA_UNITS, #PDCOMM_GEM_DATA_CACHED 중 하나입니다. |
out_item | 새 항목을 받습니다. 먼저 NULL로 설정됩니다. NULL이 아니어야 합니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다(캐시가 빈 경우 포함). endpoint 또는 out_item이 NULL이거나 field를 알 수 없으면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. id가 정의되지 않았으면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 엔드포인트가 장비가 아니거나 데이터 저장소가 없으면 #PDCOMM_INVALID_STATE를 반환합니다. 그 밖에 #PDCOMM_BACKPRESSURE, #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, #PDCOMM_POISONED를 반환합니다.
참고
- 소유권: pdcomm_secs_destroy()로 항목을 해제합니다. 항목은 이후의 저장소 변경이나 엔드포인트와 무관합니다.