Win32 API 日本語リファレンス
ホームUI.TabletPC › RECO_LATTICE

RECO_LATTICE

構造体
サイズx64: 56 バイト / x86: 28 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
ulColumnCountDWORD4+0+0ラティス内の列の数です。
pLatticeColumnsRECO_LATTICE_COLUMN*8/4+8+4ラティスに含まれる RECO_LATTICE_COLUMN 構造体の配列です。
ulPropertyCountDWORD4+16+8ラティスに割り当てられているプロパティの数です。プロパティの詳細については、RECO_LATTICE_PROPERTIES 構造体を参照してください。
pGuidPropertiesGUID*8/4+24+12プロパティ GUID の配列です。これらのプロパティの GUID には、Msinkaut.h ヘッダー ファイルで定義されているプロパティ (行メトリックなど) か、認識エンジンが定義するカスタム プロパティを指定できます。
ulBestResultColumnCountDWORD4+32+16最良の結果を構成する列の数です。
pulBestResultColumnsDWORD*8/4+40+20最良の結果を構成する pLatticeColumns 配列内の列のインデックスを格納する配列です。
pulBestResultIndexesDWORD*8/4+48+24pulBestResultColumn で指定された対応する列の pLatticeElements 配列内にある要素のインデックスの配列です。

公式ドキュメント

ラティスへのエントリ ポイントとして機能します。

解説(Remarks)

ulBestResultColumnCountpulBestResultColumnspulBestResultIndexes の各メンバーは、すべての列にわたる上位の代替候補に関する情報を保持するために組み合わせて使用されます。これらの値は、セグメント化が行われず列が 1 つしかない最も単純な場合でも、認識エンジンによって設定される必要があります。「together」のを使用すると、最良の結果が「to gather」であると認識エンジンが判断した場合、ulBestResultColumnCount は 3 になり、pulBestResultColumns 配列には [0,1,2] が、pulBestResultIndexes 配列には [1,0,2] が格納されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// RECO_LATTICE  (x64 56 / x86 28 バイト)
typedef struct RECO_LATTICE {
    DWORD ulColumnCount;
    RECO_LATTICE_COLUMN* pLatticeColumns;
    DWORD ulPropertyCount;
    GUID* pGuidProperties;
    DWORD ulBestResultColumnCount;
    DWORD* pulBestResultColumns;
    DWORD* pulBestResultIndexes;
} RECO_LATTICE;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RECO_LATTICE
{
    public uint ulColumnCount;
    public IntPtr pLatticeColumns;
    public uint ulPropertyCount;
    public IntPtr pGuidProperties;
    public uint ulBestResultColumnCount;
    public IntPtr pulBestResultColumns;
    public IntPtr pulBestResultIndexes;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RECO_LATTICE
    Public ulColumnCount As UInteger
    Public pLatticeColumns As IntPtr
    Public ulPropertyCount As UInteger
    Public pGuidProperties As IntPtr
    Public ulBestResultColumnCount As UInteger
    Public pulBestResultColumns As IntPtr
    Public pulBestResultIndexes As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class RECO_LATTICE(ctypes.Structure):
    _fields_ = [
        ("ulColumnCount", wintypes.DWORD),
        ("pLatticeColumns", ctypes.c_void_p),
        ("ulPropertyCount", wintypes.DWORD),
        ("pGuidProperties", ctypes.c_void_p),
        ("ulBestResultColumnCount", wintypes.DWORD),
        ("pulBestResultColumns", ctypes.c_void_p),
        ("pulBestResultIndexes", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct RECO_LATTICE {
    pub ulColumnCount: u32,
    pub pLatticeColumns: *mut core::ffi::c_void,
    pub ulPropertyCount: u32,
    pub pGuidProperties: *mut core::ffi::c_void,
    pub ulBestResultColumnCount: u32,
    pub pulBestResultColumns: *mut core::ffi::c_void,
    pub pulBestResultIndexes: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type RECO_LATTICE struct {
	ulColumnCount uint32
	pLatticeColumns uintptr
	ulPropertyCount uint32
	pGuidProperties uintptr
	ulBestResultColumnCount uint32
	pulBestResultColumns uintptr
	pulBestResultIndexes uintptr
}
type
  RECO_LATTICE = record
    ulColumnCount: DWORD;
    pLatticeColumns: Pointer;
    ulPropertyCount: DWORD;
    pGuidProperties: Pointer;
    ulBestResultColumnCount: DWORD;
    pulBestResultColumns: Pointer;
    pulBestResultIndexes: Pointer;
  end;
const RECO_LATTICE = extern struct {
    ulColumnCount: u32,
    pLatticeColumns: ?*anyopaque,
    ulPropertyCount: u32,
    pGuidProperties: ?*anyopaque,
    ulBestResultColumnCount: u32,
    pulBestResultColumns: ?*anyopaque,
    pulBestResultIndexes: ?*anyopaque,
};
type
  RECO_LATTICE {.bycopy.} = object
    ulColumnCount: uint32
    pLatticeColumns: pointer
    ulPropertyCount: uint32
    pGuidProperties: pointer
    ulBestResultColumnCount: uint32
    pulBestResultColumns: pointer
    pulBestResultIndexes: pointer
struct RECO_LATTICE
{
    uint ulColumnCount;
    void* pLatticeColumns;
    uint ulPropertyCount;
    void* pGuidProperties;
    uint ulBestResultColumnCount;
    void* pulBestResultColumns;
    void* pulBestResultIndexes;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; RECO_LATTICE サイズ: 28 バイト(x86)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; ulColumnCount : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pLatticeColumns : RECO_LATTICE_COLUMN* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; ulPropertyCount : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pGuidProperties : GUID* (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; ulBestResultColumnCount : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pulBestResultColumns : DWORD* (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; pulBestResultIndexes : DWORD* (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RECO_LATTICE サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; ulColumnCount : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pLatticeColumns : RECO_LATTICE_COLUMN* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; ulPropertyCount : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pGuidProperties : GUID* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; ulBestResultColumnCount : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; pulBestResultColumns : DWORD* (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; pulBestResultIndexes : DWORD* (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global RECO_LATTICE
    #field int ulColumnCount
    #field intptr pLatticeColumns
    #field int ulPropertyCount
    #field intptr pGuidProperties
    #field int ulBestResultColumnCount
    #field intptr pulBestResultColumns
    #field intptr pulBestResultIndexes
#endstruct

stdim st, RECO_LATTICE        ; NSTRUCT 変数を確保
st->ulColumnCount = 100
mes "ulColumnCount=" + st->ulColumnCount