pdcomm_gem_configure_formatted_program_capabilities
함수
GEM 엔드포인트에서 정형 프로그램 기능(capability) 서비스를 활성화합니다.
PdcommStatus pdcomm_gem_configure_formatted_program_capabilities(PdcommTcpEndpoint *endpoint, const PdcommGemFormattedProgramCapabilityOptions *options)GEM 호스트 또는 장비를 구성한 뒤 엔드포인트가 정지된 동안 한 번 호출합니다. 서비스는 크기가 제한된 큐를 미리 할당합니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | GEM 역할이 구성된 TCP 엔드포인트입니다. |
options | 서비스 한도입니다. ::PdcommGemFormattedProgramCapabilityOptions를 참고합니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. endpoint 또는 options가 NULL이거나, options->struct_size가 너무 작거나, version이 #PDCOMM_GEM_FORMATTED_PROGRAM_CAPABILITY_OPTIONS_VERSION이 아니거나, reserved가 0이 아니거나, 큐 한도(max_pending, max_received, max_results, max_history)가 0이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 엔드포인트가 정지 상태가 아니거나, 준비된 이벤트(staged event)가 있거나, GEM 역할이 없거나, 이미 기능 서비스가 구성되었으면 #PDCOMM_INVALID_STATE를 반환합니다. 큐를 할당할 수 없으면 #PDCOMM_ALLOCATION_FAILED를 반환합니다. 이전 패닉(panic)으로 엔드포인트가 오염(poisoned) 상태가 되었으면 #PDCOMM_POISONED를 반환합니다.