pdcomm_gem_equipment_report_value
함수
보고서 VID 하나의 현재 값을 로컬 저장소만으로 해석합니다.
PdcommStatus pdcomm_gem_equipment_report_value(PdcommTcpEndpoint *endpoint, uint32_t vid, PdcommSecsItem **out_item)바인딩 저장소를 사용하며, 바인딩 저장소가 설치되어 있지 않으면 기존 방식인 상태 변수 해석을 사용하고, 데이터 변수 캐시도 사용합니다. 샘플은 적용하지 않습니다. 회선에 보낼 보고서 전체를 미리 검사하지는 않습니다. 반환된 항목에는 해당 출처 저장소의 항목 한도가 적용됩니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 장비 엔드포인트입니다. |
vid | 보고서에서 쓰는 변수 ID(VID)입니다. |
out_item | 값의 독립된 사본을 받습니다. 먼저 NULL로 설정됩니다. NULL이 아니어야 합니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. endpoint 또는 out_item이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. VID가 바인딩되지 않았거나 출처가 없으면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 엔드포인트가 장비가 아니거나, VID가 캐시된 값이 없는 데이터 변수에 바인딩되어 있거나, 데이터 저장소가 없으면 #PDCOMM_INVALID_STATE를 반환합니다. 그 밖에 #PDCOMM_BACKPRESSURE, #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, #PDCOMM_POISONED를 반환합니다.
참고
- 소유권: pdcomm_secs_destroy()로 항목을 해제합니다.