Win32 API 日本語リファレンス
ホームMedia.Speech › SPPHRASEPROPERTY

SPPHRASEPROPERTY

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

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

フィールド

フィールドサイズx64x86説明
pszNameLPWSTR8/4+0+0セマンティックプロパティの名前(Unicode文字列)。
Anonymous_Anonymous_e__Union8/4+8+4プロパティIDを保持する無名共用体(ulId等)。
pszValueLPWSTR8/4+16+8プロパティの文字列値。無ければNULL可。
vValueVARIANT32/24+24+16プロパティの値をVARIANT型で保持する。
ulFirstElementDWORD4+56+40このプロパティが対応する最初の要素のインデックス。
ulCountOfElementsDWORD4+60+44このプロパティが含む要素の数。
pNextSiblingSPPHRASEPROPERTY*8/4+64+48同階層の次の兄弟プロパティへのポインタ。無ければNULL。
pFirstChildSPPHRASEPROPERTY*8/4+72+52最初の子プロパティへのポインタ。無ければNULL。
SREngineConfidenceFLOAT4+80+56認識エンジンによる信頼度スコア(0.0~1.0)。
ConfidenceCHAR1+84+60プロパティの信頼度レベル(SP_LOW/NORMAL/HIGH)。

共用体: _Anonymous_e__Union x64 8B / x86 4B

フィールドサイズx64x86説明
ulIdDWORD4+0+0
Anonymous_Anonymous_e__Struct8/4+0+0プロパティIDを保持する無名共用体(ulId等)。

各言語での定義

#include <windows.h>

// VARIANT  (x64 32 / x86 24 バイト)
typedef struct VARIANT {
    _Anonymous_e__Union Anonymous;
} VARIANT;

// SPPHRASEPROPERTY  (x64 88 / x86 64 バイト)
typedef struct SPPHRASEPROPERTY {
    LPWSTR pszName;
    _Anonymous_e__Union Anonymous;
    LPWSTR pszValue;
    VARIANT vValue;
    DWORD ulFirstElement;
    DWORD ulCountOfElements;
    SPPHRASEPROPERTY* pNextSibling;
    SPPHRASEPROPERTY* pFirstChild;
    FLOAT SREngineConfidence;
    CHAR Confidence;
} SPPHRASEPROPERTY;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VARIANT
{
    public _Anonymous_e__Union Anonymous;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SPPHRASEPROPERTY
{
    public IntPtr pszName;
    public _Anonymous_e__Union Anonymous;
    public IntPtr pszValue;
    public VARIANT vValue;
    public uint ulFirstElement;
    public uint ulCountOfElements;
    public IntPtr pNextSibling;
    public IntPtr pFirstChild;
    public float SREngineConfidence;
    public sbyte Confidence;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VARIANT
    Public Anonymous As _Anonymous_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SPPHRASEPROPERTY
    Public pszName As IntPtr
    Public Anonymous As _Anonymous_e__Union
    Public pszValue As IntPtr
    Public vValue As VARIANT
    Public ulFirstElement As UInteger
    Public ulCountOfElements As UInteger
    Public pNextSibling As IntPtr
    Public pFirstChild As IntPtr
    Public SREngineConfidence As Single
    Public Confidence As SByte
End Structure
import ctypes
from ctypes import wintypes

class VARIANT(ctypes.Structure):
    _fields_ = [
        ("Anonymous", _Anonymous_e__Union),
    ]

class SPPHRASEPROPERTY(ctypes.Structure):
    _fields_ = [
        ("pszName", ctypes.c_void_p),
        ("Anonymous", _Anonymous_e__Union),
        ("pszValue", ctypes.c_void_p),
        ("vValue", VARIANT),
        ("ulFirstElement", wintypes.DWORD),
        ("ulCountOfElements", wintypes.DWORD),
        ("pNextSibling", ctypes.c_void_p),
        ("pFirstChild", ctypes.c_void_p),
        ("SREngineConfidence", ctypes.c_float),
        ("Confidence", ctypes.c_byte),
    ]
#[repr(C)]
pub struct VARIANT {
    pub Anonymous: _Anonymous_e__Union,
}

#[repr(C)]
pub struct SPPHRASEPROPERTY {
    pub pszName: *mut core::ffi::c_void,
    pub Anonymous: _Anonymous_e__Union,
    pub pszValue: *mut core::ffi::c_void,
    pub vValue: VARIANT,
    pub ulFirstElement: u32,
    pub ulCountOfElements: u32,
    pub pNextSibling: *mut core::ffi::c_void,
    pub pFirstChild: *mut core::ffi::c_void,
    pub SREngineConfidence: f32,
    pub Confidence: i8,
}
import "golang.org/x/sys/windows"

type VARIANT struct {
	Anonymous _Anonymous_e__Union
}

type SPPHRASEPROPERTY struct {
	pszName uintptr
	Anonymous _Anonymous_e__Union
	pszValue uintptr
	vValue VARIANT
	ulFirstElement uint32
	ulCountOfElements uint32
	pNextSibling uintptr
	pFirstChild uintptr
	SREngineConfidence float32
	Confidence int8
}
type
  VARIANT = record
    Anonymous: _Anonymous_e__Union;
  end;

  SPPHRASEPROPERTY = record
    pszName: Pointer;
    Anonymous: _Anonymous_e__Union;
    pszValue: Pointer;
    vValue: VARIANT;
    ulFirstElement: DWORD;
    ulCountOfElements: DWORD;
    pNextSibling: Pointer;
    pFirstChild: Pointer;
    SREngineConfidence: Single;
    Confidence: Shortint;
  end;
const VARIANT = extern struct {
    Anonymous: _Anonymous_e__Union,
};

const SPPHRASEPROPERTY = extern struct {
    pszName: ?*anyopaque,
    Anonymous: _Anonymous_e__Union,
    pszValue: ?*anyopaque,
    vValue: VARIANT,
    ulFirstElement: u32,
    ulCountOfElements: u32,
    pNextSibling: ?*anyopaque,
    pFirstChild: ?*anyopaque,
    SREngineConfidence: f32,
    Confidence: i8,
};
type
  VARIANT {.bycopy.} = object
    Anonymous: _Anonymous_e__Union

  SPPHRASEPROPERTY {.bycopy.} = object
    pszName: pointer
    Anonymous: _Anonymous_e__Union
    pszValue: pointer
    vValue: VARIANT
    ulFirstElement: uint32
    ulCountOfElements: uint32
    pNextSibling: pointer
    pFirstChild: pointer
    SREngineConfidence: float32
    Confidence: int8
struct VARIANT
{
    _Anonymous_e__Union Anonymous;
}

struct SPPHRASEPROPERTY
{
    void* pszName;
    _Anonymous_e__Union Anonymous;
    void* pszValue;
    VARIANT vValue;
    uint ulFirstElement;
    uint ulCountOfElements;
    void* pNextSibling;
    void* pFirstChild;
    float SREngineConfidence;
    byte Confidence;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SPPHRASEPROPERTY サイズ: 64 バイト(x86)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; pszName : LPWSTR (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; pszValue : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; vValue : VARIANT (+16, 24byte)  varptr(st)+16 を基点に操作(24byte:入れ子/配列)
; ulFirstElement : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ulCountOfElements : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; pNextSibling : SPPHRASEPROPERTY* (+48, 4byte)  varptr(st)+48 を基点に操作(4byte:入れ子/配列)
; pFirstChild : SPPHRASEPROPERTY* (+52, 4byte)  varptr(st)+52 を基点に操作(4byte:入れ子/配列)
; SREngineConfidence : FLOAT (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; Confidence : CHAR (+60, 1byte)  poke st,60,値  /  値 = peek(st,60)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SPPHRASEPROPERTY サイズ: 88 バイト(x64)
dim st, 22    ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; pszName : LPWSTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; Anonymous : _Anonymous_e__Union (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; pszValue : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; vValue : VARIANT (+24, 32byte)  varptr(st)+24 を基点に操作(32byte:入れ子/配列)
; ulFirstElement : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ulCountOfElements : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; pNextSibling : SPPHRASEPROPERTY* (+64, 8byte)  varptr(st)+64 を基点に操作(8byte:入れ子/配列)
; pFirstChild : SPPHRASEPROPERTY* (+72, 8byte)  varptr(st)+72 を基点に操作(8byte:入れ子/配列)
; SREngineConfidence : FLOAT (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; Confidence : CHAR (+84, 1byte)  poke st,84,値  /  値 = peek(st,84)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global VARIANT
    #field byte Anonymous 32
#endstruct

#defstruct global SPPHRASEPROPERTY
    #field intptr pszName
    #field byte Anonymous 8
    #field intptr pszValue
    #field VARIANT vValue
    #field int ulFirstElement
    #field int ulCountOfElements
    #field intptr pNextSibling
    #field intptr pFirstChild
    #field float SREngineConfidence
    #field byte Confidence
#endstruct

stdim st, SPPHRASEPROPERTY        ; NSTRUCT 変数を確保
st->ulFirstElement = 100
mes "ulFirstElement=" + st->ulFirstElement
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。