XSpeechToTextCancelHypothesisString
Annule une hypothèse et supprime sa chaîne d’une superposition de texte.Syntaxe
Paramètres
hypothesisId _In_Type : uint32_t ID d’hypothèse renvoyé par XSpeechToTextBeginHypothesisString.
Valeur de retour
Type : HRESULT HRESULT de réussite ou code d’erreur.Remarques
Cette fonction annule une hypothèse et supprime 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’est pas encore finalisée ou annulée, sa valeur hypothesisId devient non valide. Le passage d’une valeur hypothesisId non valide ne renvoie 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’a pas appeléXSpeechToTextFinalizeHypothesisString. Sauf si l’hypothèse est annulée, votre application doit toujours appeler XSpeechToTextFinalizeHypothesisString pour garantir l’affichage de la chaîne.
Pour obtenir des exemples de code, consultez la section Remarques de XSpeechToTextBeginHypothesisString.