グレイサーチオブジェクトの生成

Namespace: fvalgcli
Assembly: fvalgcli_fga (in fvalgcli_fga.dll) Version: 3.1.0.0 (3.1.0.3)

Syntax

C#
public static FHANDLE fnFGA_gs2_alloc(
	uint first_buff_size,
	uint last_buff_size,
	uint cache_pow_num
)
Visual Basic
Public Shared Function fnFGA_gs2_alloc ( 
	first_buff_size As UInteger,
	last_buff_size As UInteger,
	cache_pow_num As UInteger
) As FHANDLE

Parameters

first_buff_size
Type: System..::..UInt32
初期サーチ結果候補初期バッファサイズ。 通常は0を指定してください。0を指定すると、デフォルト値を使用します。 初期サイズが小さく、メモリが足りなくなった場合には内部で自動で再アロケートを行いますが、 メモリの再アロケートを少なくしたい等の理由で、初期サイズを変更する場合に指定します。 なお、この設定値によってサーチ結果が変化することはありません。
last_buff_size
Type: System..::..UInt32
最終サーチ結果候補初期バッファサイズ。 通常は0を指定してください。0を指定すると、デフォルト値を使用します。 初期サイズが小さく、メモリが足りなくなった場合には内部で自動で再アロケートを行いますが、 メモリの再アロケートを少なくしたい等の理由で、初期サイズを変更する場合に指定します。 なお、この設定値によってサーチ結果が変化することはありません。
cache_pow_num
Type: System..::..UInt32
中間スコアキャッシュサイズ( 0 または 3〜15 ) 。 通常は0を指定してください。0を指定すると、デフォルト値を使用します。 本ライブラリでは重複した相関スコアの計算を避けるために、既に計算した 相関スコアを一時的に保存するキャッシュ領域を持ちます。 本パラメータはこの相関スコアのキャッシュサイズを指定します。 大きな値を設定するとキャッシュヒット率が上がる場合がありますが、 その効果はわずかな場合が多く、必要なメモリ量が大幅に増えるため、 デフォルト値以外での利用は推奨しません。 なお、この設定値によってサーチ結果が変化することはありません。

Return Value

Type: FHANDLE
正常終了した場合は、生成したグレイサーチオブジェクトのハンドルを返します。 ライセンスエラー、パラメータエラー又はメモリ不足エラーにより生成できなかったときはNULLを返します。

Remarks

Examples

C# Copy imageCopy
//    $Revision: 1.2 $

using System;
using System.Collections.Generic;
using System.Text;
using System.Diagnostics;
using fvalgcli;

namespace TC
{
    public partial class FIE
    {
        [FvPluginExecute]
        public void fnFGA_gs2_alloc()
        {
            FHANDLE hgs = FHANDLE.Zero;

            try
            {
                // グレイサーチオブジェクトの生成.
                uint first_buff_size = 0;
                uint last_buff_size = 0;
                uint cache_pow_num = 0;
                hgs = fga.fnFGA_gs2_alloc(first_buff_size, last_buff_size, cache_pow_num);
                if (hgs == IntPtr.Zero)
                    throw new FvException(f_err.F_ERR_NOMEMORY, "エラーが発生しました。");
            }
            finally
            {
                // 解放.
                hgs.Dispose();
            }
        }
    }
}

Exceptions

ExceptionCondition
System.IO..::..FileNotFoundException 実行環境に NVIDIA CUDA Runtime が存在しない場合、FGA ライブラリのロードが失敗し、この例外が発行されます。
必要な環境については FGA ライブラリ説明書 をご参照ください。
例外メッセージの例 (32bit 日本語 O/S の場合):
DLL 'fgamt.x86.3.0.0.dll' を読み込めません: 指定されたモジュールが見つかりません。 (HRESULT からの例外: 0x8007007E)

See Also