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

ISpeechRecoResultDispatch

COMIDispatch (デュアル)
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID6d60eb64-aced-40a6-bbf3-4e557f71dee2継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 13

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_RecoContext(ISpeechRecoContext** RecoContext)
RecoContextISpeechRecoContext**outこの結果を生成した認識コンテキストISpeechRecoContextを受け取る出力ポインタ。
vtbl 8 HRESULT get_Times(ISpeechRecoResultTimes** Times)
TimesISpeechRecoResultTimes**out認識結果の開始・経過時刻情報ISpeechRecoResultTimesを受け取る出力ポインタ。
vtbl 9 HRESULT putref_AudioFormat(ISpeechAudioFormat* Format)
FormatISpeechAudioFormat*inoptional結果に関連付けるオーディオ形式ISpeechAudioFormatを設定する入力ポインタ。
vtbl 10 HRESULT get_AudioFormat(ISpeechAudioFormat** Format)
FormatISpeechAudioFormat**out結果に関連付けられたオーディオ形式ISpeechAudioFormatを受け取る出力ポインタ。
vtbl 11 HRESULT get_PhraseInfo(ISpeechPhraseInfo** PhraseInfo)
PhraseInfoISpeechPhraseInfo**out認識されたフレーズの詳細情報ISpeechPhraseInfoを受け取る出力ポインタ。
vtbl 12 HRESULT Alternates(INT RequestCount, INT StartElement, INT Elements, ISpeechPhraseAlternates** Alternates)
RequestCountINTin取得を要求する代替候補の最大件数。
StartElementINTin代替候補の対象範囲の開始要素インデックス。
ElementsINTin代替候補の対象範囲に含める要素数。-1で残り全要素を指定する。
AlternatesISpeechPhraseAlternates**out得られた代替候補コレクションISpeechPhraseAlternatesを受け取る出力ポインタ。
vtbl 13 HRESULT Audio(INT StartElement, INT Elements, ISpeechMemoryStream** Stream)
StartElementINTin再生対象のオーディオ範囲の開始要素インデックス。
ElementsINTin再生対象に含める要素数。0で全範囲を指定する。
StreamISpeechMemoryStream**out切り出したオーディオデータを格納したISpeechMemoryStreamを受け取る出力ポインタ。
vtbl 14 HRESULT SpeakAudio(INT StartElement, INT Elements, SpeechVoiceSpeakFlags Flags, INT* StreamNumber)
StartElementINTin読み上げ対象範囲の開始要素インデックス。
ElementsINTin読み上げ対象に含める要素数。0で全範囲を指定する。
FlagsSpeechVoiceSpeakFlagsin読み上げ動作を制御するSpeechVoiceSpeakFlags列挙のフラグ(非同期/XML解釈等)。
StreamNumberINT*out発行された読み上げストリーム番号を受け取る出力先。
vtbl 15 HRESULT SaveToMemory(VARIANT* ResultBlock)
ResultBlockVARIANT*out結果オブジェクト全体をシリアライズしたバイナリブロックをVARIANTで受け取る出力先。
vtbl 16 HRESULT DiscardResultInfo(SpeechDiscardType ValueTypes)
ValueTypesSpeechDiscardTypein破棄する情報の種別を指定するSpeechDiscardType列挙のフラグ。メモリ節約に用いる。
vtbl 17 HRESULT GetXMLResult(SPXMLRESULTOPTIONS Options, LPWSTR* pResult)
OptionsSPXMLRESULTOPTIONSin出力XMLの整形方法を指定するSPXMLRESULTOPTIONS列挙値。
pResultLPWSTR*out生成されたSML(認識結果XML)文字列を受け取る出力先。BSTRへのポインタで指定する。
vtbl 18 HRESULT GetXMLErrorInfo(INT* LineNumber, LPWSTR* ScriptLine, LPWSTR* Source, LPWSTR* Description, HRESULT* ResultCode, VARIANT_BOOL* IsError)
LineNumberINT*outXML処理でエラーが発生した行番号を受け取る出力先。INTへのポインタで指定する。
ScriptLineLPWSTR*outエラーが発生したスクリプト行の内容を受け取る出力先。BSTRへのポインタで指定する。
SourceLPWSTR*outエラーの発生元を示す文字列を受け取る出力先。BSTRへのポインタで指定する。
DescriptionLPWSTR*outエラーの説明文を受け取る出力先。BSTRへのポインタで指定する。
ResultCodeHRESULT*outエラーの結果コードを受け取る出力先。HRESULTへのポインタで指定する。
IsErrorVARIANT_BOOL*outエラーが存在するか否かを受け取る出力先。VARIANT_BOOLで表す。
vtbl 19 HRESULT SetTextFeedback(LPWSTR Feedback, VARIANT_BOOL WasSuccessful)
FeedbackLPWSTRin認識結果に対するユーザーの訂正テキスト等のフィードバック文字列。BSTRで指定する。
WasSuccessfulVARIANT_BOOLinフィードバックが成功(妥当)であったかを示すVARIANT_BOOL値。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_ISpeechRecoResultDispatch "{6D60EB64-ACED-40A6-BBF3-4E557F71DEE2}"
#usecom global ISpeechRecoResultDispatch IID_ISpeechRecoResultDispatch "{}"
#comfunc global ISpeechRecoResultDispatch_get_RecoContext     7 sptr
#comfunc global ISpeechRecoResultDispatch_get_Times           8 sptr
#comfunc global ISpeechRecoResultDispatch_putref_AudioFormat  9 sptr
#comfunc global ISpeechRecoResultDispatch_get_AudioFormat     10 sptr
#comfunc global ISpeechRecoResultDispatch_get_PhraseInfo      11 sptr
#comfunc global ISpeechRecoResultDispatch_Alternates          12 int,int,int,sptr
#comfunc global ISpeechRecoResultDispatch_Audio               13 int,int,sptr
#comfunc global ISpeechRecoResultDispatch_SpeakAudio          14 int,int,int,var
#comfunc global ISpeechRecoResultDispatch_SaveToMemory        15 var
#comfunc global ISpeechRecoResultDispatch_DiscardResultInfo   16 int
#comfunc global ISpeechRecoResultDispatch_GetXMLResult        17 int,var
#comfunc global ISpeechRecoResultDispatch_GetXMLErrorInfo     18 var,var,var,var,var,var
#comfunc global ISpeechRecoResultDispatch_SetTextFeedback     19 wstr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。