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

Namespace: fvalgcli
Assembly: fvalgcli (in fvalgcli.dll) Version: 3.1.0.0 (3.1.0.11)

Syntax

C#
public static FHANDLE fnFIE_gs2_alloc(
	uint first_buff_size,
	uint last_buff_size,
	uint cache_pow_num
)
Visual Basic
Public Shared Function fnFIE_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
正常終了した場合は、生成したグレイサーチオブジェクトのハンドルを返します。 ライセンスエラー、パラメータエラー又はメモリ不足エラーにより生成できなかったときは IntPtr.Zero を返します。

Remarks

Examples

C# Copy imageCopy
//    $Revision: 1.1 $

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

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

            try
            {
                // グレイサーチオブジェクトの生成.
                uint first_buff_size = 0;
                uint last_buff_size = 0;
                uint cache_pow_num = 0;
                hgs = api.fnFIE_gs2_alloc(first_buff_size, last_buff_size, cache_pow_num);
                Assert.IsTrue(hgs != FHANDLE.Zero, "fnFIE_gs2_alloc: エラーが発生しました。({0})", hgs);
            }
            finally
            {
                // 解放.
                hgs.Dispose();
            }
        }
    }
}

Visual Basic Copy imageCopy
'    $Revision: 1.1 $

Imports System.Collections.Generic
Imports System.Text
Imports fvalgcli

Public Partial Class FIE
    <FvPluginExecute> _
    Public Sub fnFIE_gs2_alloc()
        Dim hgs As FHANDLE = FHANDLE.Zero

        Try
            ' グレイサーチオブジェクトの生成.
            Dim first_buff_size As UInteger = 0
            Dim last_buff_size As UInteger = 0
            Dim cache_pow_num As UInteger = 0
            hgs = api.fnFIE_gs2_alloc(first_buff_size, last_buff_size, cache_pow_num)
            Assert.IsTrue(hgs <> FHANDLE.Zero, "fnFIE_gs2_alloc: エラーが発生しました。({0})", hgs)
        Finally
            ' 解放.
            hgs.Dispose()
        End Try
    End Sub
End Class

See Also