pdcomm_secs1_event_body
함수
수신 이벤트의 본문을 복사합니다.
PdcommStatus pdcomm_secs1_event_body(const PdcommSecs1Event *event, uint8_t *output, size_t capacity, size_t *required)다른 종류의 이벤트는 본문이 비어 있습니다. 복사는 원자적이므로 버퍼가 짧으면 변경하지 않습니다. 크기를 조회하려면 NULL과 용량 0을 전달합니다.
매개변수
| 이름 | 설명 |
|---|---|
event | 유효한 이벤트입니다. |
output | 대상 버퍼입니다. 본문이 비어 있거나 capacity가 0인 크기 조회에서는 NULL일 수 있습니다. |
capacity | output의 크기(바이트)입니다. |
required | 본문 길이를 받습니다. NULL이 아니어야 합니다. |
반환값
본문을 복사하면 #PDCOMM_OK를 반환합니다. capacity가 *required보다 작으면 #PDCOMM_BUFFER_TOO_SMALL을 반환하며 출력은 변경하지 않습니다. event 또는 required가 NULL이거나(*required는 기록하지 않음), 본문이 비어 있지 않고 용량이 충분한데 output이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다.
참고
- 스레드 안전성: 같은 이벤트에 대한 다른 읽기와 어느 스레드에서나 동시에 실행할 수 있습니다. 해제는 동기화해야 합니다.