連続取り込み情報の取得 (フレーム待機)
Namespace: FVIL.VideoAssembly: FVILdevice (in FVILdevice.dll) Version: 3.1.0.0 (3.1.0.5)
Syntax
C# |
---|
public override CFviWaitFrame NotifyCaptureNo() |
Visual Basic |
---|
Public Overrides Function NotifyCaptureNo As CFviWaitFrame |
Return Value
Type: CFviWaitFrame連続取り込み情報を取得します。 1フレーム取り込み完了するまで待機します。
連続取り込み の実行中にご使用ください。 画像取り込みが行われていない場合は、即時に制御が戻ります。 その際、戻り値の CFviWaitFrame 構造体の AmountInFrame メンバは 0 に設定されています。
トータルフレーム枚数は、取り込み実行時に 0 になり、 4294967295(0xFFFFFFFF)まで増加した後、0(0x00)に戻ります。
本メソッドは、画像取込中に行うため、画像転送(DMA)中にキャプチャボードのレジスタから値を参照することになります。 バスに大きな負担がかかる画像転送(DMA)中に更にレジスタ参照による負荷をかけることになりますので速度の速いカメラをご使用の場合などに頻繁に参照するとご使用条件によっては画像入力の転送性能等に悪影響を及ぼす可能性もあります。 そのため頻繁に参照を行う事はお勧めいたしません。
処理に失敗した場合は例外を発行します。 例外の原因と発生位置を特定するには、発行された例外クラスの ErrorCode メンバと Function メンバを参照してください。
エラーコード:
値 | ErrorCode メンバ | 内容 |
---|---|---|
25 | FVIL.ErrorCode.NOT_OPENED | デバイスがオープンされていません。 |
Exceptions
Exception | Condition |
---|---|
FVIL..::..CFviException | この例外の原因については、上記のエラーコード表をご参照ください。 |