pdcomm_gem_formatted_program_selection_snapshot_software_revision_copy
함수
선택된 프로그램의 SOFTREV를 복사합니다.
PdcommStatus pdcomm_gem_formatted_program_selection_snapshot_software_revision_copy(const PdcommGemFormattedProgramSelectionSnapshot *snapshot, char *output, size_t capacity, size_t *required)pdcomm_gem_formatted_program_selection_snapshot_model_copy()와 마찬가지로, 스냅샷이 NULL이거나 비어 있으면 *required를 기록하지 않습니다.
매개변수
| 이름 | 설명 |
|---|---|
snapshot | 프로그램을 담은 유효한 스냅샷입니다. |
output | ASCII 바이트를 받을 대상 버퍼입니다. capacity가 0일 때만 NULL일 수 있습니다. |
capacity | output의 크기(바이트)입니다. |
required | 텍스트 길이를 받습니다. |
반환값
텍스트를 복사하면 #PDCOMM_OK를 반환합니다. capacity가 *required보다 작으면 #PDCOMM_BUFFER_TOO_SMALL을 반환하며 출력은 변경하지 않습니다. snapshot 또는 required가 NULL이거나, capacity가 0이 아닌데 output이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 스냅샷에 선택된 프로그램이 없으면 #PDCOMM_INVALID_STATE를 반환합니다. 패닉(panic)을 격리했으면 #PDCOMM_INTERNAL_ERROR를 반환합니다.