pdcomm_gem_result_event_value
함수
수신한 S6F11에 있는 보고서 하나의 값 하나를 복사합니다.
PdcommStatus pdcomm_gem_result_event_value(const PdcommGemResult *result, size_t report_index, size_t value_index, PdcommSecsItem **out_item)값에는 VID가 없습니다. value_index 위치는 보고서 정의에서 같은 위치에 있는 VID에 대응합니다.
매개변수
| 이름 | 설명 |
|---|---|
result | 결과 유형이 #PDCOMM_GEM_EVENT_RECEIVED인 결과입니다. |
report_index | 메시지 안에서 0부터 시작하는 보고서 위치입니다. |
value_index | 보고서 안에서 0부터 시작하는 값 위치입니다. |
out_item | 독립적으로 소유하는 새 항목을 받습니다. 먼저 NULL로 설정되므로 실패하면 항상 NULL입니다. NULL이 아니어야 합니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. result 또는 out_item이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. result가 수신한 이벤트 보고서가 아니면 #PDCOMM_INVALID_STATE를 반환합니다. 어느 한 인덱스라도 범위를 벗어나면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 그 밖에 #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, #PDCOMM_INTERNAL_ERROR를 반환합니다.
참고
- 소유권: pdcomm_secs_destroy()로 항목을 해제합니다. 항목은 결과, TCP 이벤트, 엔드포인트가 해제된 뒤에도 유효합니다.