ホーム › Media.Speech › ISpeechGrammarRules
ISpeechGrammarRules
COMIDispatch (デュアル)✅ IDispatch を実装(デュアルインターフェース)。HSP では
comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。メソッド 8
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
| Count | INT* | out | コレクション内のルール数を受け取るポインタ。 |
vtbl 8 HRESULT FindRule(VARIANT RuleNameOrId, ISpeechGrammarRule** Rule)
| RuleNameOrId | VARIANT | in | 検索対象のルール名または数値IDを保持するVARIANT。 |
| Rule | ISpeechGrammarRule** | out | 見つかったルール(ISpeechGrammarRule)を受け取るポインタ。 |
vtbl 9 HRESULT Item(INT Index, ISpeechGrammarRule** Rule)
| Index | INT | in | 取得するルールの0起点インデックス。 |
| Rule | ISpeechGrammarRule** | out | そのインデックスのルール(ISpeechGrammarRule)を受け取るポインタ。 |
| EnumVARIANT | IUnknown** | out | 反復用の列挙子(IEnumVARIANT)を受け取るIUnknownポインタ。 |
vtbl 11 HRESULT get_Dynamic(VARIANT_BOOL* Dynamic)
| Dynamic | VARIANT_BOOL* | out | 文法が動的(実行時変更可能)かを受け取るVARIANT_BOOLポインタ。 |
vtbl 12 HRESULT Add(LPWSTR RuleName, SpeechRuleAttributes Attributes, INT RuleId, ISpeechGrammarRule** Rule)
| RuleName | LPWSTR | in | 追加するルールの名前。 |
| Attributes | SpeechRuleAttributes | in | ルールの属性(SpeechRuleAttributes)。 |
| RuleId | INT | in | ルールに割り当てる数値ID。 |
| Rule | ISpeechGrammarRule** | out | 追加したルール(ISpeechGrammarRule)を受け取るポインタ。 |
vtbl 13 HRESULT Commit()
| ErrorText | LPWSTR* | out | コンパイルエラーが生じた場合のエラーメッセージを受け取るポインタ。 |
| SaveStream | VARIANT* | out | コンパイル済み文法のバイナリを受け取るVARIANTポインタ。 |
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_ISpeechGrammarRules "{6FFA3B44-FC2D-40D1-8AFC-32911C7F1AD1}" #usecom global ISpeechGrammarRules IID_ISpeechGrammarRules "{}" #comfunc global ISpeechGrammarRules_get_Count 7 var #comfunc global ISpeechGrammarRules_FindRule 8 int,sptr #comfunc global ISpeechGrammarRules_Item 9 int,sptr #comfunc global ISpeechGrammarRules_get__NewEnum 10 sptr #comfunc global ISpeechGrammarRules_get_Dynamic 11 var #comfunc global ISpeechGrammarRules_Add 12 wstr,int,int,sptr #comfunc global ISpeechGrammarRules_Commit 13 #comfunc global ISpeechGrammarRules_CommitAndSave 14 var,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ISpeechGrammarRules "{6FFA3B44-FC2D-40D1-8AFC-32911C7F1AD1}" #usecom global ISpeechGrammarRules IID_ISpeechGrammarRules "{}" #comfunc global ISpeechGrammarRules_get_Count 7 sptr #comfunc global ISpeechGrammarRules_FindRule 8 int,sptr #comfunc global ISpeechGrammarRules_Item 9 int,sptr #comfunc global ISpeechGrammarRules_get__NewEnum 10 sptr #comfunc global ISpeechGrammarRules_get_Dynamic 11 sptr #comfunc global ISpeechGrammarRules_Add 12 wstr,int,int,sptr #comfunc global ISpeechGrammarRules_Commit 13 #comfunc global ISpeechGrammarRules_CommitAndSave 14 sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。