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

가설을 취소하고 텍스트 오버레이에서 해당 문자열을 제거합니다.

<a id="syntaxSection" />

## 구문

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

<a id="parametersSection" />

### 매개 변수

*hypothesisId*   \_In\_\
형식: uint32\_t

[XSpeechToTextBeginHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring)이 반환한 가설 ID입니다.

<a id="retvalSection" />

### 반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.

<a id="remarksSection" />

## 설명

이 함수는 가설을 취소하고 오버레이에서 해당 문자열을 제거합니다.

오버레이는 제한된 수의 문자열만 표시할 수 있습니다. 최대치에 도달하면 오래된 문자열은 만료됩니다. 만료된 문자열이 아직 확정되거나 취소되지 않은 가설이라면, 해당 *hypothesisId* 값은 무효화됩니다. 잘못된 *hypothesisId* 값을 전달해도 오류를 반환하지 않습니다.

오버레이의 가설 문자열을 업데이트하려면 [XSpeechToTextUpdateHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring)을 사용합니다.

가설을 확정하려면 [XSpeechToTextFinalizeHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring)을 사용합니다.

일부 플랫폼에서는 앱이 `XSpeechToTextFinalizeHypothesisString`을 호출할 때까지 가설 문자열이 표시되지 않습니다. 가설이 취소되지 않는 한, 앱은 문자열이 표시되도록 하기 위해 항상 `XSpeechToTextFinalizeHypothesisString`을 호출해야 합니다.

코드 예제는 [XSpeechToTextBeginHypothesisString](/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring)의 [설명](/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring#remarksSection) 섹션을 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** XAccessibility.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

<a id="seealsoSection" />

## 함께 보기

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


## Related topics

- [XSpeechToTextUpdateHypothesisString](/ko/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring.md)
- [XSpeechToTextFinalizeHypothesisString](/ko/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring.md)
- [XSpeechToTextBeginHypothesisString](/ko/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md)
- [XAccessibility](/ko/reference/system/xaccessibility/xaccessibility_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)