連続取り込み情報の取得 (即時)

Namespace: FVIL.Video
Assembly: FVILdevice (in FVILdevice.dll) Version: 3.1.0.0 (3.1.0.5)

Syntax

C#
public override CFviWaitFrame QueryCaptureNo()
Visual Basic
Public Overrides Function QueryCaptureNo As CFviWaitFrame

Return Value

Type: CFviWaitFrame

連続取り込み情報を取得します。 1フレーム取り込み完了を待たずに即時 制御が戻ります。

連続取り込み の実行中にご使用ください。 画像取り込みが行われていない場合は、即時に制御が戻ります。 その際、戻り値の CFviWaitFrame 構造体の AmountInFrame メンバは 0 です。

トータルフレーム枚数は、取り込み実行時に 0 になり、 4294967295(0xFFFFFFFF)まで増加した後、0(0x00)に戻ります。

ライン数(LineCount)は、TAP毎のライン数になります。カメラによっては、 取得できる最大ライン数が画像メモリの半分となる場合があります。

本メソッドは、画像取込中に行うため、画像転送(DMA)中にキャプチャボードのレジスタから値を参照することになります。 バスに大きな負担がかかる画像転送(DMA)中に更にレジスタ参照による負荷をかけることになりますので速度の速いカメラをご使用の場合などに頻繁に参照するとご使用条件によっては画像入力の転送性能等に悪影響を及ぼす可能性もあります。 そのため頻繁に参照を行う事はお勧めいたしません。

処理に失敗した場合は例外を発行します。 例外の原因と発生位置を特定するには、発行された例外クラスの ErrorCode メンバと Function メンバを参照してください。

エラーコード:

ErrorCode メンバ内容
25FVIL.ErrorCode.NOT_OPENEDデバイスがオープンされていません。

Exceptions

ExceptionCondition
FVIL..::..CFviExceptionこの例外の原因については、上記のエラーコード表をご参照ください。

See Also