デバイスのオープン

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

Syntax

C#
public override void Open(
	int id,
	int option
)
Visual Basic
Public Overrides Sub Open ( 
	id As Integer,
	option As Integer
)

Parameters

id
Type: System..::..Int32
ボードID
option
Type: System..::..Int32
オプション

Remarks

ビデオ入力デバイスをオープンします。 引数 option は、本クラスでは使用しません。常に 0 を指定して下さい。 引数 id に指定可能な値を下表に示します。


許容値:
内容
-1オープン可能で最も小さいIDを持つボード
0~15ボードID

当クラスの関数は、キャプチャボードのオープンが完了していない場合、エラーを返します。 パラメータ設定や画像取り込みを行う場合は、必ずキャプチャボードのオープンを行ってください。 デバイスをオープンする為には、デバイスドライバがインストールされ起動している必要があります。 デバイスドライバが起動するには、対応するデバイスがPCに実装されていなければいけません。 デバイス上にはディップスイッチ(SW1)があり、このスイッチでデバイスIDを指定できます。 本関数で -1 以外のIDを指定した場合、デバイスIDと一致するデバイスをオープンします。 この時指定したIDのデバイスが見つからなかった場合、エラーとなります。 本関数でIDに -1 を指定した場合、最も数字の少ないIDを持つデバイスをオープンします。

オープン完了後、LoadIniFile(String) で カメラ設定ファイルの読み込みを行ってください。

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

エラーコード:

ErrorCode メンバ内容
55FVIL.ErrorCode.ALREADY_OPENED既にオープンされています。2重オープンは出来ません。
11FVIL.ErrorCode.INVALID_PARAMETER引数に指定された値が不正です。
1FVIL.ErrorCode.FAILED_TO_ALLOCATEメモリの確保に失敗しました。
2FVIL.ErrorCode.FAILED_TO_OPEN キャプチャボードのオープンに失敗しました。 デバイスドライバが正常に動作しているか確認してください。 また、IDを-1以外に指定した場合、指定IDのボードがPC上に見つからなかった場合も、このエラーを返します。

Exceptions

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

See Also