XSpeechToTextCancelHypothesisString
Annule une hypothèse et retire sa chaîne d’une superposition de texte.Syntaxe
Paramètres
hypothesisId _In_Type : uint32_t L’identificateur d’hypothèse retourné par XSpeechToTextBeginHypothesisString.
Valeur de retour
Type : HRESULT Code HRESULT de réussite ou d’erreur.Remarques
Cette fonction annule une hypothèse et retire sa chaîne de la superposition. La superposition ne peut afficher qu’un nombre limité de chaînes. Lorsque le maximum est atteint, les chaînes les plus anciennes expirent. Si une chaîne expirée est une hypothèse qui n’a pas encore été finalisée ou annulée, sa valeur hypothesisId devient non valide. Passer une valeur hypothesisId non valide ne retourne pas d’erreur. Pour mettre à jour une chaîne d’hypothèse dans la superposition, utilisez XSpeechToTextUpdateHypothesisString. Pour finaliser une hypothèse, utilisez XSpeechToTextFinalizeHypothesisString. Sur certaines plateformes, la chaîne d’hypothèse n’est pas affichée tant que l’application n’appelle pasXSpeechToTextFinalizeHypothesisString. À moins que l’hypothèse ne soit annulée, votre application doit toujours appeler XSpeechToTextFinalizeHypothesisString pour s’assurer que la chaîne est affichée.
Pour des exemples de code, consultez la section Remarques de XSpeechToTextBeginHypothesisString.