画像メモリロック

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

Syntax

C#
public override void MemoryLock(
	uint num
)
Visual Basic
Public Overrides Sub MemoryLock ( 
	num As UInteger
)

Parameters

num
Type: System..::..UInt32
ロック画像枚数 (1~)

Remarks

画像メモリをロックし、連続取り込みが行える状態にします。 予め、連続取り込み先の画像オブジェクトのコレクション に指定枚数の画像オブジェクトを設定しておいてください。 ロックした画像メモリを解放したり、サイズ変更してはいけません。

Imagesで、FVIL.ImageType.UC8の画像をロックし、画像入力を行った場合、 グレイ画像で、画像取り込みが行われます。
Imagesで、FVIL.ImageType.BINの画像をロックし、画像入力を行った場合、 2値画像で、画像取り込みが行われます。

画像オブジェクトの画像サイズは、すべてのフレームにおいて、入力画像サイズと等しいか、大きくなければいけません。
また、画像タイプはすべてのフレームにおいて、FVIL.ImageType.UC8または、FVIL.ImageType.BINに統一されていなければなりません。
横方向画像サイズは8byte単位でなければいけません。

本メソッドは、MemoryLock(CFviPoint, UInt32)の 第1引数に、(0,0)を設定して実行した場合と同じ動作となります。

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

エラーコード：

値ErrorCode メンバ内容
1FVIL.ErrorCode.FAILED_TO_ALLOCATEメモリの確保に失敗しました。
11FVIL.ErrorCode.INVALID_PARAMETER引数が不正です。
16FVIL.ErrorCode.INVALID_IMAGETYPE画像タイプが、UC8またはBINで以外です。
17FVIL.ErrorCode.INVALID_IMAGESIZE画像サイズが、入力画像よりも小さいです。または、画像サイズが65536以上です。
25FVIL.ErrorCode.NOT_OPENEDデバイスがオープンされていません。
31046FVIL.Video.ErrorCode.MEMORY_LOCK メモリロックに失敗しました。 ロックするだけの連続メモリが足りない可能性があります。
31078FVIL.Video.ErrorCode.SET_PARAMETER画像情報を設定できません。
31079FVIL.Video.ErrorCode.GET_PARAMETERボードから情報を取得できません。

Exceptions

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

See Also