画像メモリの先頭アドレスの取得 (Offset を無視する)

Namespace: FVIL.Data
Assembly: FVILbasic (in FVILbasic.dll) Version: 3.1.0.0 (3.1.0.17)

Syntax

C#
public virtual IntPtr GetRootAdrs(
	int ch
)
Visual Basic
Public Overridable Function GetRootAdrs ( 
	ch As Integer
) As IntPtr

Parameters

ch
Type: System..::..Int32
チャネル番号 [0~]

Return Value

Type: IntPtr
画像メモリの先頭アドレスを返します。
メモリが確保されていない場合は、引数の整合性に関わらず常に IntPtr.Zero が返ります。

Remarks

このアドレスは、FIE ハンドル(GetFIE)のルート画像から取得される画像アドレスです。 ポインタ走査を行う場合は、オフセットを考慮する必要がありますので GetImageAdrs をご使用ください。 FIE ハンドル(GetFIE)が F_OBJID_IMG_ROOT の場合は GetImageAdrs と等価ですが、 F_OBJID_IMG_CHILD の場合、x=0,y=0 の位置は、このアドレスにオフセットを加算した位置になります。

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

エラーコード：

値ErrorCode メンバ内容
11FVIL.ErrorCode.INVALID_PARAMETERチャネル番号が不正です。

Exceptions

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

See Also