エラーコード一覧

PUCLIB の API 関数が失敗（PUC_SUCCEEDED 以外）を返した際のエラーコード一覧と、開発時・運用時の推奨対処法です。

エラーハンドリングの基本方針

C/C++ SDK の API 関数は、処理結果として PUCRESULT 型を返します。SDK に用意されている判定マクロを使用することで、処理の成功・失敗を簡潔に分岐できます。

#include "PUCLIB.h"

PUCRESULT res = PUC_OpenDevice2(0, &hDevice);

// エラー判定マクロの使用例
if (PUC_CHK_FAILED(res)) {
    // エラー発生時の処理
    if (res == PUC_ERROR_DEVICE_OPEN) {
        // デバイスの再リセットを試行
        PUC_ResetDevice(deviceNo);
    }
}

エラーコード一覧 (`PUCRESULT`)

コード	定数名	概要
`0`	`PUC_SUCCEEDED`	正常終了
`1`	`PUC_ERROR_UNINITIALIZE`	初期化されていません。`PUC_Initialize()` を実行してください
`2`	`PUC_ERROR_INITIALIZED`	既に初期化されています
`3`	`PUC_ERROR_NOT_EXIST_DEVICE_NO`	指定されたデバイス番号は存在しません
`4`	`PUC_ERROR_ILLEGAL_DEVICE_HANDLE`	指定されたデバイスハンドルが `NULL` です
`5`	`PUC_ERROR_ILLEGAL_ARG`	指定された引数が `NULL`、または不正な値です
`6`	`PUC_ERROR_ILLEGAL_RESOLUTION`	指定された解像度は設定できません
`7`	`PUC_ERROR_ILLEGAL_FRAME_RATE`	指定された撮影速度は設定できません
`8`	`PUC_ERROR_ILLEGAL_EXPOSE_CLOCK`	指定された露光期間または非露光期間（クロック単位）は設定できません
`9`	`PUC_ERROR_DEVICE_OPEN`	デバイスのオープンに失敗しました
`10`	`PUC_ERROR_DEVICE_NOTOPEN`	デバイスがオープンされていません
`11`	`PUC_ERROR_DEVICE_READ`	デバイスからのデータ読み取りに失敗しました
`12`	`PUC_ERROR_DEVICE_WRITE`	デバイスへのデータ書き込みに失敗しました
`13`	`PUC_ERROR_MODULE_LOAD`	SDK内の一部モジュールがロードできませんでした
`14`	`PUC_ERROR_LOCK_TIMEOUT`	関数の排他処理がタイムアウトしました
`15`	`PUC_ERROR_GET_CMD`	デバイスへの取得コマンド送信に失敗しました
`16`	`PUC_ERROR_SET_CMD`	デバイスへの設定コマンド送信に失敗しました
`17`	`PUC_ERROR_NOTEQUAL_READ_SIZE`	デバイスから意図したサイズのデータを読み込めませんでした
`18`	`PUC_ERROR_NOTEQUAL_WRITE_SIZE`	デバイスに意図したサイズのデータを書き込めませんでした
`19`	`PUC_ERROR_XFER_DATA_INVALID_HEADER`	デバイスから受信したデータのヘッダー情報が不正です
`20`	`PUC_ERROR_XFER_DATA_BEGIN`	データ転送が開始できませんでした
`21`	`PUC_ERROR_XFER_DATA_WAIT`	デバイスからのデータ転送待ちで意図せぬ問題が発生しました
`22`	`PUC_ERROR_XFER_DATA_FINISH`	データ転送終了が正常に行われませんでした
`23`	`PUC_ERROR_XFERRING`	転送中のため処理できませんでした（連続ストリーミング中の設定変更など）
`24`	`PUC_ERROR_RING_BUF_COUNT`	指定されたリングバッファ数が不正です
`25`	`PUC_ERROR_SYNC_EXTERNAL`	外部同期中のため処理できませんでした
`26`	`PUC_ERROR_NOTSUPPORT`	この関数（機能）は接続中のカメラではサポートされていません
`27`	`PUC_ERROR_GPU_DECODE_PROCESS`	GPUデコード処理に失敗しました
`28`	`PUC_ERROR_ALLOCATE_BUFFUER`	バッファの確保に失敗しました
`29`	`PUC_ERROR_FREE_BUFFER`	バッファの解放に失敗しました
`30`	`PUC_ERROR_GPU_SYNCHRONIZE`	GPU処理の同期に失敗しました
`31`	`PUC_ERROR_GPU_MEMORY_COPY`	GPUメモリのコピーに失敗しました
`32`	`PUC_ERROR_GPU_UNINITIALIZE`	GPU処理に必要なセットアップが行われていません。`PUC_SetupGPUDecode` を実行してください
`33`	`PUC_ERROR_GET_ADAPTER_INFO`	ネットワークアダプタ情報の取得に失敗しました（`PUC_GetAdaptersInfoList`）
`34`	`PUC_ERROR_DETECT_DEVICE`	デバイスの検索に失敗しました（`PUC_DetectDevice2` / `PUC_DiscoveryDevice` など）
`35`	`PUC_ERROR_SET_NETWORK_SETTING`	デバイスへのネットワーク設定の書き込みに失敗しました（`PUC_ForceSetNetworkSetting`）
`36`	`PUC_ERROR_DEVICE_CLOSE`	デバイスのクローズに失敗しました
`37`	`PUC_ERROR_NO_SYNC`	外部同期信号が検出されません

トラブルシューティング & 復旧手順

デバイスオープンに失敗する場合 (`PUC_ERROR_DEVICE_OPEN`)

カメラが認識されているにもかかわらずオープンに失敗する場合、ハードウェアまたは前回の未開放ハンドルが残っている可能性があります。

PUC_ResetDevice によるハードウェアリセット

PUC_ResetDevice(nDeviceNo) を呼び出してカメラの内部状態をクリアします。
再オープン試行

リセット後、再度 PUC_OpenDevice2() を実行します。

接続中のカメラが機能に対応していない場合 (`PUC_ERROR_NOTSUPPORT`)

UC-1.1 / GbE-2 は対応している機能（SYNC OUT 出力倍率、ネットワーク設定など）が異なります。機種名で分岐するのではなく、事前に PUC_IsSupported で対応可否を確認してから該当 API を呼び出してください。