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