pdcomm_gem_formatted_program_capability_catalog_clear
함수
장비가 게시하는 기능(capability) 카탈로그를 제거합니다.
PdcommStatus pdcomm_gem_formatted_program_capability_catalog_clear(PdcommTcpEndpoint *endpoint, uint64_t *out_revision)카탈로그가 설치되어 있었으면 리비전이 1 증가하며, 빈 카탈로그를 비우면 리비전을 유지합니다. 카탈로그가 비어 있는 동안 pdcomm_gem_formatted_program_capability_respond()는 아직 카탈로그를 확보하지 않은 요청에 대해 #PDCOMM_INVALID_STATE를 반환합니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 기능 서비스가 구성된 장비 엔드포인트입니다. |
out_revision | 호출 후의 카탈로그 리비전을 받습니다. 먼저 0으로 설정되므로 실패하면 항상 0입니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. out_revision 또는 endpoint가 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 엔드포인트가 GEM 장비가 아니거나 기능 서비스가 구성되지 않았으면 #PDCOMM_INVALID_STATE를 반환합니다. 리비전 카운터가 소진되면 #PDCOMM_LIMIT_EXCEEDED를 반환합니다. 엔드포인트에 준비된 TCP 이벤트(staged event)가 있으면 #PDCOMM_BACKPRESSURE를 반환합니다. #PDCOMM_POISONED를 반환할 수도 있습니다.