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

# XSpeechToTextUpdateHypothesisString

> XSpeechToTextUpdateHypothesisString

# XSpeechToTextUpdateHypothesisString

Atualiza uma cadeia de caracteres de hipótese em uma sobreposição de texto.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT XSpeechToTextUpdateHypothesisString(  
         uint32_t hypothesisId,  
         const char* content  
)  
```

<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).

*content*   \_In\_z\_\
Tipo: char\*

A cadeia de caracteres atualizada da hipótese.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

HRESULT de êxito ou código de erro.

<a id="remarksSection" />

## Comentários

Esta função atualiza uma cadeia de caracteres de hipótese no local, sem movê-la para a parte inferior 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 cancelar uma hipótese e removê-la da sobreposição, use [XSpeechToTextCancelHypothesisString](/pt-BR/reference/system/xaccessibility/functions/xspeechtotextcancelhypothesisstring).

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](/pt-BR/reference/system/xaccessibility/functions/xspeechtotextcancelhypothesisstring.md)
- [XSpeechToTextFinalizeHypothesisString](/pt-BR/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring.md)
- [XSpeechToTextBeginHypothesisString](/pt-BR/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md)
- [XAccessibility](/pt-BR/reference/system/xaccessibility/xaccessibility_members.md)
- [Wrappers de API C# do Unity para o GDK](/pt-BR/build/gdk-and-engines/unity/unity-api-wrappers.md)