다음을 통해 공유


XClosedCaptionSetEnabled

선택 자막을 활성화 또는 비활성화할지 여부를 나타내는 부울 값을 설정합니다.

구문

HRESULT XClosedCaptionSetEnabled(  
         bool enabled  
)  

매개 변수

enabled _In_
형식: bool

선택 자막을 활성화 또는 비활성화할지 여부를 나타내는 부울 값입니다.

반환 값

형식: HRESULT

성공한 경우 HRESULT를 반환합니다. 그렇지 않으면 오류 코드를 반환합니다.
오류 코드 목록은 오류 코드를 참조하세요.

설명

참고 항목

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.

이 함수를 성공적으로 수행하려면 선택 자막을 사용하도록 설정해야 합니다. 사용자는 게임 타이틀의 UI에서 선택 자막 기능을 사용하도록 설정해야 합니다.

선택 자막에 활성화로 플래그를 지정하려면 enabled를 true 또는 1로 설정합니다. 선택 자막에 비활성화로 플래그를 지정하려면 enabled를 false 또는 1로 설정합니다.

다음 예에서는 선택 자막을 프로그래밍 방식으로 활성화하는 방법을 보여줍니다.

//The user must first enable closed captions in the UI of the Game title. Afterwards, the game title can set the Boolean flag.
if (SUCCEEDED(XClosedCaptionsSetEnabled(true)))
{
    // Closed captions successfully enabled
}

요구 사항

헤더: XAccessibility.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XAccessibility

XClosedCaptionProperties

XClosedCaptionGetProperties