pdcomm_gem_result_status_value
함수
S1F4 결과에서 상태 변수 값 하나를 복사합니다.
PdcommStatus pdcomm_gem_result_status_value(const PdcommGemResult *result, size_t index, uint32_t *out_id, uint8_t *id_present, PdcommSecsItem **out_item)결과 유형이 #PDCOMM_GEM_VALUES_RECEIVED인 결과만 이 함수를 지원하며, 값 개수는 entry_count로 알 수 있습니다. ID를 지정한 요청이면 값은 요청 순서를 따르고 각 값이 요청한 ID를 보고합니다. 모든 변수를 요청했으면 S1F4에 ID가 없으므로 id_present는 0입니다. 값이 빈 List라고 해서 변수를 알 수 없다는 뜻은 아닙니다. 장비는 알 수 없는 SVID에 빈 List를 반환하지만, 알려진 변수도 빈 List 값을 가질 수 있습니다.
매개변수
| 이름 | 설명 |
|---|---|
result | 유효한 결과입니다. |
index | 0부터 시작하는 값 인덱스입니다. |
out_id | 요청한 SVID 또는 0을 받습니다. 먼저 0으로 설정됩니다. |
id_present | out_id가 유효하면 1, 아니면 0을 받습니다. 먼저 0으로 설정됩니다. |
out_item | 값의 사본을 소유하는 새 항목을 받습니다. 먼저 NULL로 설정됩니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. 포인터 중 하나라도 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 결과 유형이 #PDCOMM_GEM_VALUES_RECEIVED가 아니면 #PDCOMM_INVALID_STATE를 반환합니다. index가 entry_count보다 작지 않으면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 그 밖에 #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED 또는 #PDCOMM_INTERNAL_ERROR를 반환합니다.
참고
- 소유권: pdcomm_secs_destroy()로 항목을 해제합니다.
- 모든 출력은 쓸 수 있어야 하며 서로 겹치거나 결과와 겹치면 안 됩니다.