SPRECORESULTINFO

構造体

サイズx64: 80 バイト / x86: 56 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
cbSize	DWORD	4	+0	+0	この構造体のサイズをバイトで示す。
eResultType	SPRESULTTYPE	4	+4	+4	認識結果の種類(SPRESULTTYPE。フレーズか代替か)。
fHypothesis	BOOL	4	+8	+8	暫定(仮説)結果ならTRUEとなる真偽値。
fProprietaryAutoPause	BOOL	4	+12	+12	エンジン独自の自動一時停止が有効ならTRUE。
ullStreamPosStart	ULONGLONG	8	+16	+16	結果の音声開始位置をストリームバイトオフセットで示す。
ullStreamPosEnd	ULONGLONG	8	+24	+24	結果の音声終了位置をストリームバイトオフセットで示す。
hGrammar	SPGRAMMARHANDLE	8/4	+32	+32	結果を生成した文法のハンドル(SPGRAMMARHANDLE)。
ulSizeEngineData	DWORD	4	+40	+36	pvEngineDataが指すエンジン固有データのバイト数。
pvEngineData	void*	8/4	+48	+40	エンジン固有データへのポインタ。NULL可。
pPhrase	ISpPhraseBuilder*	8/4	+56	+44	認識フレーズを構築するISpPhraseBuilderへのポインタ。
aPhraseAlts	SPPHRASEALT*	8/4	+64	+48	代替候補(SPPHRASEALT)配列へのポインタ。
ulNumAlts	DWORD	4	+72	+52	代替候補の数。

各言語での定義

#include <windows.h>

// SPRECORESULTINFO  (x64 80 / x86 56 バイト)
typedef struct SPRECORESULTINFO {
    DWORD cbSize;
    SPRESULTTYPE eResultType;
    BOOL fHypothesis;
    BOOL fProprietaryAutoPause;
    ULONGLONG ullStreamPosStart;
    ULONGLONG ullStreamPosEnd;
    SPGRAMMARHANDLE hGrammar;
    DWORD ulSizeEngineData;
    void* pvEngineData;
    ISpPhraseBuilder* pPhrase;
    SPPHRASEALT* aPhraseAlts;
    DWORD ulNumAlts;
} SPRECORESULTINFO;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SPRECORESULTINFO
{
    public uint cbSize;
    public int eResultType;
    [MarshalAs(UnmanagedType.Bool)] public bool fHypothesis;
    [MarshalAs(UnmanagedType.Bool)] public bool fProprietaryAutoPause;
    public ulong ullStreamPosStart;
    public ulong ullStreamPosEnd;
    public IntPtr hGrammar;
    public uint ulSizeEngineData;
    public IntPtr pvEngineData;
    public IntPtr pPhrase;
    public IntPtr aPhraseAlts;
    public uint ulNumAlts;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SPRECORESULTINFO
    Public cbSize As UInteger
    Public eResultType As Integer
    <MarshalAs(UnmanagedType.Bool)> Public fHypothesis As Boolean
    <MarshalAs(UnmanagedType.Bool)> Public fProprietaryAutoPause As Boolean
    Public ullStreamPosStart As ULong
    Public ullStreamPosEnd As ULong
    Public hGrammar As IntPtr
    Public ulSizeEngineData As UInteger
    Public pvEngineData As IntPtr
    Public pPhrase As IntPtr
    Public aPhraseAlts As IntPtr
    Public ulNumAlts As UInteger
End Structure

import ctypes
from ctypes import wintypes

class SPRECORESULTINFO(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("eResultType", ctypes.c_int),
        ("fHypothesis", wintypes.BOOL),
        ("fProprietaryAutoPause", wintypes.BOOL),
        ("ullStreamPosStart", ctypes.c_ulonglong),
        ("ullStreamPosEnd", ctypes.c_ulonglong),
        ("hGrammar", ctypes.c_void_p),
        ("ulSizeEngineData", wintypes.DWORD),
        ("pvEngineData", ctypes.c_void_p),
        ("pPhrase", ctypes.c_void_p),
        ("aPhraseAlts", ctypes.c_void_p),
        ("ulNumAlts", wintypes.DWORD),
    ]

#[repr(C)]
pub struct SPRECORESULTINFO {
    pub cbSize: u32,
    pub eResultType: i32,
    pub fHypothesis: i32,
    pub fProprietaryAutoPause: i32,
    pub ullStreamPosStart: u64,
    pub ullStreamPosEnd: u64,
    pub hGrammar: *mut core::ffi::c_void,
    pub ulSizeEngineData: u32,
    pub pvEngineData: *mut core::ffi::c_void,
    pub pPhrase: *mut core::ffi::c_void,
    pub aPhraseAlts: *mut core::ffi::c_void,
    pub ulNumAlts: u32,
}

import "golang.org/x/sys/windows"

type SPRECORESULTINFO struct {
	cbSize uint32
	eResultType int32
	fHypothesis int32
	fProprietaryAutoPause int32
	ullStreamPosStart uint64
	ullStreamPosEnd uint64
	hGrammar uintptr
	ulSizeEngineData uint32
	pvEngineData uintptr
	pPhrase uintptr
	aPhraseAlts uintptr
	ulNumAlts uint32
}

type
  SPRECORESULTINFO = record
    cbSize: DWORD;
    eResultType: Integer;
    fHypothesis: BOOL;
    fProprietaryAutoPause: BOOL;
    ullStreamPosStart: UInt64;
    ullStreamPosEnd: UInt64;
    hGrammar: Pointer;
    ulSizeEngineData: DWORD;
    pvEngineData: Pointer;
    pPhrase: Pointer;
    aPhraseAlts: Pointer;
    ulNumAlts: DWORD;
  end;

const SPRECORESULTINFO = extern struct {
    cbSize: u32,
    eResultType: i32,
    fHypothesis: i32,
    fProprietaryAutoPause: i32,
    ullStreamPosStart: u64,
    ullStreamPosEnd: u64,
    hGrammar: ?*anyopaque,
    ulSizeEngineData: u32,
    pvEngineData: ?*anyopaque,
    pPhrase: ?*anyopaque,
    aPhraseAlts: ?*anyopaque,
    ulNumAlts: u32,
};

type
  SPRECORESULTINFO {.bycopy.} = object
    cbSize: uint32
    eResultType: int32
    fHypothesis: int32
    fProprietaryAutoPause: int32
    ullStreamPosStart: uint64
    ullStreamPosEnd: uint64
    hGrammar: pointer
    ulSizeEngineData: uint32
    pvEngineData: pointer
    pPhrase: pointer
    aPhraseAlts: pointer
    ulNumAlts: uint32

struct SPRECORESULTINFO
{
    uint cbSize;
    int eResultType;
    int fHypothesis;
    int fProprietaryAutoPause;
    ulong ullStreamPosStart;
    ulong ullStreamPosEnd;
    void* hGrammar;
    uint ulSizeEngineData;
    void* pvEngineData;
    void* pPhrase;
    void* aPhraseAlts;
    uint ulNumAlts;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SPRECORESULTINFO サイズ: 56 バイト(x86)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; eResultType : SPRESULTTYPE (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; fHypothesis : BOOL (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; fProprietaryAutoPause : BOOL (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ullStreamPosStart : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ullStreamPosEnd : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; hGrammar : SPGRAMMARHANDLE (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ulSizeEngineData : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; pvEngineData : void* (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; pPhrase : ISpPhraseBuilder* (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; aPhraseAlts : SPPHRASEALT* (+48, 4byte)  varptr(st)+48 を基点に操作(4byte:入れ子/配列)
; ulNumAlts : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SPRECORESULTINFO サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; eResultType : SPRESULTTYPE (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; fHypothesis : BOOL (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; fProprietaryAutoPause : BOOL (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ullStreamPosStart : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ullStreamPosEnd : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; hGrammar : SPGRAMMARHANDLE (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ulSizeEngineData : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; pvEngineData : void* (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; pPhrase : ISpPhraseBuilder* (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; aPhraseAlts : SPPHRASEALT* (+64, 8byte)  varptr(st)+64 を基点に操作(8byte:入れ子/配列)
; ulNumAlts : DWORD (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SPRECORESULTINFO
    #field int cbSize
    #field int eResultType
    #field bool fHypothesis
    #field bool fProprietaryAutoPause
    #field int64 ullStreamPosStart
    #field int64 ullStreamPosEnd
    #field intptr hGrammar
    #field int ulSizeEngineData
    #field intptr pvEngineData
    #field intptr pPhrase
    #field intptr aPhraseAlts
    #field int ulNumAlts
#endstruct

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

SPRECORESULTINFO

フィールド

各言語での定義

HSP用 定義

HSP用定義