> ## 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 una hipótesis y quita su cadena de una superposición de texto.

<a id="syntaxSection" />

## Sintaxis

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

<a id="parametersSection" />

### Parámetros

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

El identificador de hipótesis que devolvió [XSpeechToTextBeginHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring).

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Código de error o de éxito HRESULT.

<a id="remarksSection" />

## Comentarios

Esta función cancela una hipótesis y quita su cadena de la superposición.

La superposición solo puede mostrar un número limitado de cadenas. Cuando se alcanza el máximo, las cadenas más antiguas expiran. Si una cadena expirada es una hipótesis que aún no se ha finalizado ni cancelado, su valor *hypothesisId* deja de ser válido. Pasar un valor *hypothesisId* no válido no devuelve un error.

Para actualizar una cadena de hipótesis en la superposición, use [XSpeechToTextUpdateHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring).

Para finalizar una hipótesis, use [XSpeechToTextFinalizeHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring).

En algunas plataformas, la cadena de hipótesis no se muestra hasta que la aplicación llama a `XSpeechToTextFinalizeHypothesisString`. A menos que la hipótesis se cancele, la aplicación siempre debe llamar a `XSpeechToTextFinalizeHypothesisString` para garantizar que la cadena se muestre.

Para ver ejemplos de código, consulte la sección [Comentarios](/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring#remarksSection) de [XSpeechToTextBeginHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring).

<a id="requirementsSection" />

## Requisitos

**Encabezado:** XAccessibility.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

<a id="seealsoSection" />

## Consulte también

[XAccessibility](/reference/system/xaccessibility/xaccessibility_members)


## Related topics

- [XSpeechToTextUpdateHypothesisString](/es/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring.md)
- [XSpeechToTextFinalizeHypothesisString](/es/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring.md)
- [XSpeechToTextBeginHypothesisString](/es/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md)
- [XAccessibility](/es/reference/system/xaccessibility/xaccessibility_members.md)
- [Contenedores de API de C# de Unity para el GDK](/es/build/gdk-and-engines/unity/unity-api-wrappers.md)