pdcomm_gem_configure_formatted_programs
함수
엔드포인트에서 S7F27/S7F28 검증 보고서 서비스를 활성화합니다.
PdcommStatus pdcomm_gem_configure_formatted_programs(PdcommTcpEndpoint *endpoint, const PdcommGemFormattedProgramOptions *options)pdcomm_gem_configure_host() 또는 pdcomm_gem_configure_equipment() 뒤, pdcomm_tcp_start() 전에 엔드포인트가 정지된 동안 엔드포인트마다 한 번 호출합니다. 두 역할 모두 서비스를 구성할 수 있습니다. 장비는 보고서를 보내고 호스트는 보고서를 받습니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | GEM 역할이 구성된 Stopped 상태의 엔드포인트입니다. |
options | 서비스 한도입니다. 호출 중에만 읽습니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. endpoint 또는 options가 NULL이거나, options->struct_size가 너무 작거나, version 또는 reserved가 잘못되었거나, 큐 한도(max_pending, max_received, max_results, max_history)가 0이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 준비된 TCP 이벤트(staged event)를 먼저 비워야 하면 #PDCOMM_BACKPRESSURE를 반환합니다. 엔드포인트가 정지 상태가 아니거나, GEM 역할이 없거나, 이미 이 서비스가 있으면 #PDCOMM_INVALID_STATE를 반환합니다. 큐를 할당할 수 없으면 #PDCOMM_ALLOCATION_FAILED를 반환합니다. 엔드포인트가 오염(poisoned) 상태이면 #PDCOMM_POISONED를 반환합니다.
참고
- 스레드 안전성:
endpoint에 대한 다른 모든 호출과 직렬화합니다.