pdcomm_secs_payload
함수
기본형 항목의 원시 페이로드 바이트를 복사합니다.
PdcommStatus pdcomm_secs_payload(const PdcommSecsItem *handle, uint8_t *output, size_t capacity, size_t *required)숫자 요소는 회선에서와 똑같이 빅 엔디언으로 반환합니다. List에는 페이로드가 없습니다.
매개변수
| 이름 | 설명 |
|---|---|
handle | 유효한 기본형 항목입니다. |
output | 대상 버퍼입니다. 페이로드가 비어 있거나, capacity를 0으로 지정해 크기를 조회할 때는 NULL일 수 있습니다. |
capacity | output의 크기(바이트)입니다. |
required | 페이로드 길이를 받습니다. handle이 NULL이거나 List이면 0으로 유지됩니다. NULL이 아니어야 합니다. |
반환값
페이로드를 복사하면 #PDCOMM_OK를 반환합니다. capacity가 *required보다 작으면 #PDCOMM_BUFFER_TOO_SMALL을 반환하며 출력은 변경하지 않습니다. required 또는 handle이 NULL이거나, handle이 List이거나, 페이로드가 비어 있지 않고 용량이 충분한데 output이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 패닉(panic)을 격리했으면 #PDCOMM_INTERNAL_ERROR를 반환합니다.
참고
- 스레드 안전성: 같은 항목에 대한 읽기 호출은 동시에 실행할 수 있습니다. 해제는 이 호출들과 동기화해야 합니다.