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

# XSpeechToTextCancelHypothesisString

> XSpeechToTextCancelHypothesisString

# XSpeechToTextCancelHypothesisString

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

## 구문

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

### 매개 변수

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

[XSpeechToTextBeginHypothesisString](https://docs.xbox.com/ko/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md)이 반환한 가설 ID입니다.

### 반환 값

형식: HRESULT

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

## 설명

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

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

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

가설을 확정하려면 [XSpeechToTextFinalizeHypothesisString](https://docs.xbox.com/ko/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring.md)을 사용합니다.

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

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

## 요구 사항

**헤더:** XAccessibility.h

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

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

## 함께 보기

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


## Related topics

- [XSpeechToTextUpdateHypothesisString](https://docs.xbox.com/ko/reference/system/xaccessibility/functions/xspeechtotextupdatehypothesisstring.md)
- [XSpeechToTextFinalizeHypothesisString](https://docs.xbox.com/ko/reference/system/xaccessibility/functions/xspeechtotextfinalizehypothesisstring.md)
- [XSpeechToTextBeginHypothesisString](https://docs.xbox.com/ko/reference/system/xaccessibility/functions/xspeechtotextbeginhypothesisstring.md)
- [XAccessibility (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xaccessibility/xaccessibility_members.md)
- [Unity 프로젝트에서 GDK API용 C# 래퍼 사용](https://docs.xbox.com/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)