XSpeechToTextCancelHypothesisString
Cancela uma hipótese e remove a cadeia de caracteres dela de uma sobreposição de texto.Sintaxe
Parâmetros
hypothesisId _In_Tipo: uint32_t A ID da hipótese retornada por XSpeechToTextBeginHypothesisString.
Valor retornado
Tipo: HRESULT HRESULT de êxito ou código de erro.Comentários
Esta função cancela uma hipótese e remove a cadeia de caracteres dela da sobreposição. A sobreposição pode exibir apenas um número limitado de cadeias de caracteres. Quando o máximo é atingido, as cadeias de caracteres mais antigas expiram. Se uma cadeia de caracteres expirada for uma hipótese que ainda não foi finalizada nem cancelada, o valor de hypothesisId dela se tornará inválido. Passar um valor de hypothesisId inválido não retorna um erro. Para atualizar uma cadeia de caracteres de hipótese na sobreposição, use XSpeechToTextUpdateHypothesisString. Para finalizar uma hipótese, use XSpeechToTextFinalizeHypothesisString. Em algumas plataformas, a cadeia de caracteres da hipótese não é exibida até que o aplicativo chameXSpeechToTextFinalizeHypothesisString. A menos que a hipótese seja cancelada, seu aplicativo deve sempre chamar XSpeechToTextFinalizeHypothesisString para garantir que a cadeia de caracteres seja exibida.
Para obter exemplos de código, confira a seção Comentários de XSpeechToTextBeginHypothesisString.