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

# XSpeechToTextFinalizeHypothesisString

> XSpeechToTextFinalizeHypothesisString

# XSpeechToTextFinalizeHypothesisString

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

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT XSpeechToTextFinalizeHypothesisString(  
         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 versão final da cadeia de caracteres 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 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](/pt-BR/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring).

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

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

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