XSpeechToTextCancelHypothesisString
取消一个假设,并将其字符串从文本覆盖层中移除。语法
参数
hypothesisId _In_类型:uint32_t 由 XSpeechToTextBeginHypothesisString 返回的假设 ID。
返回值
类型:HRESULT HRESULT 成功或错误代码。备注
此函数取消一个假设,并将其字符串从覆盖层中移除。 覆盖层只能显示有限数量的字符串。达到最大数量时,较旧的字符串将过期。如果过期的字符串是一个尚未最终确定或取消的假设,则其 hypothesisId 值将变为无效。传入无效的 hypothesisId 值不会返回错误。 若要更新覆盖层中的假设字符串,请使用 XSpeechToTextUpdateHypothesisString。 若要最终确定假设,请使用 XSpeechToTextFinalizeHypothesisString。 在某些平台上,假设字符串在应用调用XSpeechToTextFinalizeHypothesisString 之前不会显示。除非取消假设,否则你的应用必须始终调用 XSpeechToTextFinalizeHypothesisString 以确保该字符串得以显示。
有关代码示例,请参阅 XSpeechToTextBeginHypothesisString 的备注部分。
