> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XSpeechToTextCancelHypothesisString

> XSpeechToTextCancelHypothesisString

# XSpeechToTextCancelHypothesisString

Annule une hypothèse et retire sa chaîne d'une superposition de texte.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT XSpeechToTextCancelHypothesisString(  
         uint32_t hypothesisId  
)  
```

<a id="parametersSection" />

### Paramètres

*hypothesisId*   \_In\_\
Type : uint32\_t

L'identificateur d'hypothèse retourné par [XSpeechToTextBeginHypothesisString](/fr-CA/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring).

<a id="retvalSection" />

### Valeur de retour

Type : HRESULT

Code HRESULT de réussite ou d'erreur.

<a id="remarksSection" />

## 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](/fr-CA/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring).

Pour finaliser une hypothèse, utilisez [XSpeechToTextFinalizeHypothesisString](/fr-CA/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring).

Sur certaines plateformes, la chaîne d'hypothèse n'est pas affichée tant que l'application n'appelle pas `XSpeechToTextFinalizeHypothesisString`. À 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](/fr-CA/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring#remarksSection) de [XSpeechToTextBeginHypothesisString](/fr-CA/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring).

<a id="requirementsSection" />

## Configuration requise

**En-tête :** XAccessibility.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

<a id="seealsoSection" />

## Voir aussi

[XAccessibility](/fr-CA/reference/system/xaccessibility/xaccessibility_members)


## Related topics

- [XSpeechToTextCancelHypothesisString](/es/reference/system/xaccessibility/functions/xspeechtotextcancelhypothesisstring.md)
- [XSpeechToTextUpdateHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring.md)
- [XSpeechToTextFinalizeHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring.md)
- [XSpeechToTextBeginHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md)
- [XAccessibility](/reference/system/xaccessibility/xaccessibility_members.md)