Jetson에서 isInError는 요소가 오류 상태를 기록했는지 확인한다.
개별 API 반환값 검사와 함께 사용한다.

환경과 호출 위치

실행 중 상태 확인 함수다.
반환 bool을 상위 루프에서 사용하며 이 함수만 반복 호출하는 바쁜 대기는 만들지 않는다.

인수와 동작

0은 기록된 오류가 없는 상태이고 0이 아니면 오류 상태다.
이 값만 주기적으로 본다고 모든 호출 실패의 원인이 자동으로 설명되지는 않는다.
최초 실패 위치와 반환값 로그가 필요하다.

적용할 코드

bool decoder_failed(NvVideoDecoder &dec) {
    return dec.isInError() != 0;
}

입력과 capture 스레드의 상위 종료 조건에 사용할 수 있다.
오류가 있으면 새 프레임 공급을 멈추고 정리 흐름으로 이동한다.
각 스레드의 종료 신호는 별도로 동기화한다.

샘플과 연결하기

samples/00_video_decode의 초기화 또는 capture 재설정 흐름에서 아래 함수를 호출한다.
코드 블록은 독립 실행 파일이 아니라 기존 샘플에 넣는 함수다.
기본 샘플의 입력 읽기와 버퍼 회수 루프를 유지하고 실패 시 정리 경로로 이동한다.

cd /usr/src/jetson_multimedia_api/samples/00_video_decode
make -j2
./video_decode --help

주의할 점

오류가 없다는 결과가 다음 호출도 반드시 성공한다는 보장은 아니다.
로그 검사와 API 반환값 처리를 생략하지 않는다.

기준은 Orin과 JetPack 6의 Jetson Linux R36.4이다.
설치된 nvidia-l4t-core와 Multimedia API 패키지 버전을 맞춘다.
다른 PC에서 컴파일되는 것과 Jetson에서 실제 장치가 동작하는 것은 별개다.

참고: NVIDIA R36.4 API 문서