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

RECO_ATTRS

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

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

フィールド

フィールドサイズx64x86説明
dwRecoCapabilityFlagsDWORD4+0+0認識エンジンの機能を示すフラグ群。
awcVendorNameWCHAR64+4+4認識エンジンを作成したベンダーです。
awcFriendlyNameWCHAR128+68+68

認識エンジンの人間が読みやすい名前です。

インストール済みの認識エンジンを検索するときは、この名前を指定します。

awLanguageIdWORD128+196+196

認識エンジンがサポートする言語とサブ言語の組み合わせの一覧です。この一覧は NULL で終端されます。

awcFriendlyName メンバーが空の文字列の場合は、インストール済みの認識エンジンを検索するときに言語識別子を指定します。言語識別子の作成には MAKELANGID マクロを使用します。認識エンジンが異なるサブ言語に対応する書字スタイルを区別しない場合は、サブ言語識別子に SUBLANG_NEUTRAL を指定します。

公式ドキュメント

認識エンジンの属性を取得します。または、インストール済みの認識エンジンを検索するときに使用する属性を指定します。

解説(Remarks)

この構造体を GetRecoAttributes Function の戻り値として使用する場合、awcFriendlyName パラメーターは空 (つまり最初の要素が null 文字に設定された状態) になることがあります。これはエラーではないため、GetRecoAttributes Function における awcFriendlyName の戻りコードは S_OK となり、他のフィールドにはデータが格納されます。

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

各言語での定義

#include <windows.h>

// RECO_ATTRS  (x64 324 / x86 324 バイト)
typedef struct RECO_ATTRS {
    DWORD dwRecoCapabilityFlags;
    WCHAR awcVendorName[32];
    WCHAR awcFriendlyName[64];
    WORD awLanguageId[64];
} RECO_ATTRS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RECO_ATTRS
{
    public uint dwRecoCapabilityFlags;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)] public string awcVendorName;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 64)] public string awcFriendlyName;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 64)] public ushort[] awLanguageId;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RECO_ATTRS
    Public dwRecoCapabilityFlags As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=32)> Public awcVendorName As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=64)> Public awcFriendlyName As String
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=64)> Public awLanguageId() As UShort
End Structure
import ctypes
from ctypes import wintypes

class RECO_ATTRS(ctypes.Structure):
    _fields_ = [
        ("dwRecoCapabilityFlags", wintypes.DWORD),
        ("awcVendorName", ctypes.c_wchar * 32),
        ("awcFriendlyName", ctypes.c_wchar * 64),
        ("awLanguageId", ctypes.c_ushort * 64),
    ]
#[repr(C)]
pub struct RECO_ATTRS {
    pub dwRecoCapabilityFlags: u32,
    pub awcVendorName: [u16; 32],
    pub awcFriendlyName: [u16; 64],
    pub awLanguageId: [u16; 64],
}
import "golang.org/x/sys/windows"

type RECO_ATTRS struct {
	dwRecoCapabilityFlags uint32
	awcVendorName [32]uint16
	awcFriendlyName [64]uint16
	awLanguageId [64]uint16
}
type
  RECO_ATTRS = record
    dwRecoCapabilityFlags: DWORD;
    awcVendorName: array[0..31] of WideChar;
    awcFriendlyName: array[0..63] of WideChar;
    awLanguageId: array[0..63] of Word;
  end;
const RECO_ATTRS = extern struct {
    dwRecoCapabilityFlags: u32,
    awcVendorName: [32]u16,
    awcFriendlyName: [64]u16,
    awLanguageId: [64]u16,
};
type
  RECO_ATTRS {.bycopy.} = object
    dwRecoCapabilityFlags: uint32
    awcVendorName: array[32, uint16]
    awcFriendlyName: array[64, uint16]
    awLanguageId: array[64, uint16]
struct RECO_ATTRS
{
    uint dwRecoCapabilityFlags;
    wchar[32] awcVendorName;
    wchar[64] awcFriendlyName;
    ushort[64] awLanguageId;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RECO_ATTRS サイズ: 324 バイト(x64)
dim st, 81    ; 4byte整数×81(構造体サイズ 324 / 4 切り上げ)
; dwRecoCapabilityFlags : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; awcVendorName : WCHAR (+4, 64byte)  varptr(st)+4 を基点に操作(64byte:入れ子/配列)
; awcFriendlyName : WCHAR (+68, 128byte)  varptr(st)+68 を基点に操作(128byte:入れ子/配列)
; awLanguageId : WORD (+196, 128byte)  varptr(st)+196 を基点に操作(128byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global RECO_ATTRS
    #field int dwRecoCapabilityFlags
    #field wchar awcVendorName 32
    #field wchar awcFriendlyName 64
    #field short awLanguageId 64
#endstruct

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