pdcomm_gem_formatted_program_execution_snapshot

함수

엔드포인트의 현재 실행 상태를 스냅샷으로 캡처합니다.

PdcommStatus pdcomm_gem_formatted_program_execution_snapshot(PdcommTcpEndpoint *endpoint, PdcommGemFormattedProgramExecutionSnapshotHandle **out_snapshot)

선언 위치: #include <pdcomm_gem_formatted_program_executions.h>

EMPTY를 포함한 모든 상태에서 동작합니다.

매개변수

이름	설명
`endpoint`	정형 프로그램 조회가 구성된 장비 엔드포인트입니다.
`out_snapshot`	스냅샷을 받습니다. `endpoint`가 유효하고 오염(poisoned) 상태가 아니면 먼저 NULL로 설정되므로, 이후의 모든 실패에서 NULL입니다.

반환값

성공하면 #PDCOMM_OK를 반환합니다. endpoint 또는 out_snapshot이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 엔드포인트가 GEM 장비가 아니거나 정형 프로그램 조회가 구성되지 않았으면 #PDCOMM_INVALID_STATE를 반환합니다. 사본을 만들 수 없으면 #PDCOMM_LIMIT_EXCEEDED 또는 #PDCOMM_ALLOCATION_FAILED를 반환합니다. 그 밖에 #PDCOMM_POISONED를 반환할 수 있습니다.

참고

소유권: pdcomm_gem_formatted_program_execution_snapshot_destroy()로 스냅샷을 해제합니다.