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

# XSpeechToTextUpdateHypothesisString

> XSpeechToTextUpdateHypothesisString

# XSpeechToTextUpdateHypothesisString

テキスト オーバーレイの仮説文字列を更新します。

## 構文

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

### パラメーター

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

[XSpeechToTextBeginHypothesisString](https://docs.xbox.com/ja-jp/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md) によって返された仮説 ID です。

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

更新された仮説文字列です。

### 戻り値

型: HRESULT

HRESULT の成功またはエラー コードです。

## 解説

この関数は、オーバーレイの下部に移動することなく、その場で仮説文字列を更新します。

オーバーレイに表示できる文字列の数には制限があります。 最大数に達すると、古い文字列は期限切れになります。 期限切れとなった文字列が確定またはキャンセルされていない仮説である場合、その *hypothesisId* の値は無効になります。 無効な *hypothesisId* 値を渡してもエラーは返されません。

仮説をキャンセルしてオーバーレイから削除するには、[XSpeechToTextCancelHypothesisString](https://docs.xbox.com/ja-jp/reference/system/xaccessibility/functions/xspeechtotextcancelhypothesisstring.md) を使用します。

仮説を確定するには、[XSpeechToTextFinalizeHypothesisString](https://docs.xbox.com/ja-jp/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring.md) を使用します。

一部のプラットフォームでは、アプリが `XSpeechToTextFinalizeHypothesisString` を呼び出すまで仮説文字列は表示されません。 仮説がキャンセルされない限り、文字列が確実に表示されるように、アプリは常に `XSpeechToTextFinalizeHypothesisString` を呼び出す必要があります。

コード例については、[XSpeechToTextBeginHypothesisString](https://docs.xbox.com/ja-jp/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md) の[「解説」](https://docs.xbox.com/ja-jp/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md#remarksSection)セクションを参照してください。

## 要件

**ヘッダー:** XAccessibility.h

**ライブラリ:** xgameruntime.lib

**サポートされているプラットフォーム:** Windows、XBOX One ファミリー本体、XBOX Series 本体

## 関連項目

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


## Related topics

- [XSpeechToTextCancelHypothesisString](https://docs.xbox.com/ja-jp/reference/system/xaccessibility/functions/xspeechtotextcancelhypothesisstring.md)
- [XSpeechToTextFinalizeHypothesisString](https://docs.xbox.com/ja-jp/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring.md)
- [XSpeechToTextBeginHypothesisString](https://docs.xbox.com/ja-jp/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md)
- [XAccessibility (API の内容)](https://docs.xbox.com/ja-jp/reference/system/xaccessibility/xaccessibility_members.md)
- [Unity プロジェクトでの GDK API 用 C# ラッパーの使用](https://docs.xbox.com/ja-jp/build/gdk-and-engines/unity/unity-api-wrappers.md)
