pdcomm_gem_state
함수
엔드포인트의 현재 GEM 상태를 읽습니다.
PdcommStatus pdcomm_gem_state(PdcommTcpEndpoint *endpoint, PdcommGemState *state)이 호출은 먼저 대기 중인 HSMS SELECTED 변경과 세대 변경을 반영하므로, 보고되는 통신 상태는 최신 상태입니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | GEM 역할을 가진 유효한 TCP 엔드포인트입니다. |
state | 호출자 저장 공간입니다. state->struct_size를 sizeof(PdcommGemState) 이상으로 설정합니다. 성공하면 모든 필드를 기록하고 struct_size를 기록한 크기로 설정합니다. |
반환값
성공하면 #PDCOMM_OK를 반환합니다. endpoint 또는 state가 NULL이거나 state->struct_size가 너무 작으면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 준비된 TCP 이벤트(staged event)를 먼저 가져와야 하면 #PDCOMM_BACKPRESSURE를 반환합니다. 엔드포인트에 GEM 역할이 없으면 #PDCOMM_INVALID_STATE를 반환합니다. 엔드포인트가 오염(poisoned) 상태이면 #PDCOMM_POISONED를 반환합니다.