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

# XSpeechToTextFinalizeHypothesisString

> XSpeechToTextFinalizeHypothesisString

# XSpeechToTextFinalizeHypothesisString

Finaliza uma hipótese e atualiza a cadeia de caracteres dela em uma sobreposição de texto.

## Sintaxe

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

### Parâmetros

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

A ID da hipótese retornada por [XSpeechToTextBeginHypothesisString](https://docs.xbox.com/pt-BR/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md).

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

A versão final da cadeia de caracteres da hipótese.

### Valor retornado

Tipo: HRESULT

HRESULT de êxito ou código de erro.

## Comentários

Esta função finaliza uma hipótese e atualiza a cadeia de caracteres dela 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 atualizar uma cadeia de caracteres de hipótese sem finalizá-la, use [XSpeechToTextUpdateHypothesisString](https://docs.xbox.com/pt-BR/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring.md).

Para cancelar uma hipótese e removê-la da sobreposição, use [XSpeechToTextCancelHypothesisString](https://docs.xbox.com/pt-BR/reference/system/xaccessibility/functions/xspeechtotextcancelhypothesisstring.md).

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](https://docs.xbox.com/pt-BR/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md#remarksSection) de [XSpeechToTextBeginHypothesisString](https://docs.xbox.com/pt-BR/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md).

## Requisitos

**Cabeçalho:** XAccessibility.h

**Biblioteca:** xgameruntime.lib

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

## Confira também

[XAccessibility](https://docs.xbox.com/pt-BR/reference/system/xaccessibility/xaccessibility_members.md)


## Related topics

- [XSpeechToTextCancelHypothesisString](https://docs.xbox.com/pt-BR/reference/system/xaccessibility/functions/xspeechtotextcancelhypothesisstring.md)
- [XSpeechToTextUpdateHypothesisString](https://docs.xbox.com/pt-BR/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring.md)
- [XSpeechToTextBeginHypothesisString](https://docs.xbox.com/pt-BR/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md)
- [XAccessibility (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xaccessibility/xaccessibility_members.md)
- [Usar wrappers C# para APIs do GDK no seu projeto do Unity](https://docs.xbox.com/pt-BR/build/gdk-and-engines/unity/unity-api-wrappers.md)