XSpeechToTextCancelHypothesisString
仮説をキャンセルし、その文字列をテキスト オーバーレイから削除します。構文
パラメーター
hypothesisId _In_型: uint32_t XSpeechToTextBeginHypothesisString によって返された仮説 ID です。
戻り値
型: HRESULT HRESULT の成功またはエラー コードです。解説
この関数は仮説をキャンセルし、その文字列をオーバーレイから削除します。 オーバーレイに表示できる文字列の数には制限があります。 最大数に達すると、古い文字列は期限切れになります。 期限切れとなった文字列が確定またはキャンセルされていない仮説である場合、その hypothesisId の値は無効になります。 無効な hypothesisId 値を渡してもエラーは返されません。 オーバーレイの仮説文字列を更新するには、XSpeechToTextUpdateHypothesisString を使用します。 仮説を確定するには、XSpeechToTextFinalizeHypothesisString を使用します。 一部のプラットフォームでは、アプリがXSpeechToTextFinalizeHypothesisString を呼び出すまで仮説文字列は表示されません。 仮説がキャンセルされない限り、文字列が確実に表示されるように、アプリは常に XSpeechToTextFinalizeHypothesisString を呼び出す必要があります。
コード例については、XSpeechToTextBeginHypothesisString の「解説」セクションを参照してください。