pdcomm_gem_equipment_command_parameter_at
함수
저장된 명령의 매개변수 정의 하나를 읽습니다.
PdcommStatus pdcomm_gem_equipment_command_parameter_at(PdcommTcpEndpoint *endpoint, size_t command_index, size_t parameter_index, PdcommGemCommandParameterInfo *info, PdcommSecsItem **out_name)조회 전에 *out_name을 NULL로 설정하고 info의 알려진 필드를 지웁니다. 숫자 이름은 정규화된 형식(U8, 음수이면 I8)으로 반환됩니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 명령 저장소가 구성된 엔드포인트입니다. |
command_index | 0부터 시작하는 명령 등록 인덱스입니다. |
parameter_index | 명령 안에서 0부터 시작하는 매개변수 인덱스입니다. |
info | 호출자 저장 공간입니다. 호출 전에 info->struct_size를 설정합니다. |
out_name | CPNAME을 담은 새 항목을 받습니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. endpoint, info 또는 out_name이 NULL이거나, 서로 겹치거나, info->struct_size가 너무 작으면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 어느 한 인덱스라도 범위를 벗어나면 #PDCOMM_OUT_OF_RANGE를 반환합니다. 엔드포인트에 GEM 장비나 명령 저장소가 없으면 #PDCOMM_INVALID_STATE를 반환합니다. 이름 항목을 만들 수 없으면 #PDCOMM_LIMIT_EXCEEDED 또는 #PDCOMM_ALLOCATION_FAILED를 반환합니다. 엔드포인트가 오염(poisoned) 상태이거나 패닉(panic)을 격리했으면 #PDCOMM_POISONED를 반환합니다.
참고
- 소유권: pdcomm_secs_destroy()로
*out_name을 해제합니다.