> ## 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

Cancela uma hipótese e remove a cadeia de caracteres dela de uma sobreposição de texto.

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### Parâmetros

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

A ID da hipótese retornada por [XSpeechToTextBeginHypothesisString](/pt-BR/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring).

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

HRESULT de êxito ou código de erro.

<a id="remarksSection" />

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

Para finalizar uma hipótese, use [XSpeechToTextFinalizeHypothesisString](/pt-BR/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring).

Em algumas plataformas, a cadeia de caracteres da hipótese não é exibida até que o aplicativo chame `XSpeechToTextFinalizeHypothesisString`. 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](/pt-BR/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring#remarksSection) de [XSpeechToTextBeginHypothesisString](/pt-BR/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** XAccessibility.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

<a id="seealsoSection" />

## Confira também

[XAccessibility](/pt-BR/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)