Skip to main content

XSpeechToTextCancelHypothesisString

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

구문

매개 변수

hypothesisId   _In_
형식: uint32_t
XSpeechToTextBeginHypothesisString이 반환한 가설 ID입니다.

반환 값

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

설명

이 함수는 가설을 취소하고 오버레이에서 해당 문자열을 제거합니다. 오버레이는 제한된 수의 문자열만 표시할 수 있습니다. 최대치에 도달하면 오래된 문자열은 만료됩니다. 만료된 문자열이 아직 확정되거나 취소되지 않은 가설이라면, 해당 hypothesisId 값은 무효화됩니다. 잘못된 hypothesisId 값을 전달해도 오류를 반환하지 않습니다. 오버레이의 가설 문자열을 업데이트하려면 XSpeechToTextUpdateHypothesisString을 사용합니다. 가설을 확정하려면 XSpeechToTextFinalizeHypothesisString을 사용합니다. 일부 플랫폼에서는 앱이 XSpeechToTextFinalizeHypothesisString을 호출할 때까지 가설 문자열이 표시되지 않습니다. 가설이 취소되지 않는 한, 앱은 문자열이 표시되도록 하기 위해 항상 XSpeechToTextFinalizeHypothesisString을 호출해야 합니다. 코드 예제는 XSpeechToTextBeginHypothesisString설명 섹션을 참조하세요.

요구 사항

헤더: XAccessibility.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

함께 보기

XAccessibility
마지막 수정일 2026년 8월 24일